IOleInPlaceSiteEx::RequestUIActivate
Notifies the
container that the object is about to enter the UI-active state.
HRESULT
RequestUIActivate(void);
Return Values
This method
supports the standard return value E_FAIL, as well as the following:
S_OK
The object
can continue the activation process and call IOleInPlaceSite::OnUIActivate.
S_FALSE
The object
cannot enter the UI-active state. The object must call IOleInPlaceSite::OnUIDeactivate
so the container can perform its the necessary processing to restore the focus.
Remarks
An object
calls this method to determine if it can enter the UI-active state and to
notify the container that it is about to make this transition. The container
can return S_FALSE to deny this request, for example, if the end user has
canceled the operation or if the currently active object will not relinquish
its active state.
If the object
does not call RequestUIActivate, the container handles data validation
and fires Enter and Exit events from IOleInPlaceSite::OnUIActivate.
See Also