Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IOleInPlaceSiteEx::RequestUIActivate method

Notifies the container that the object is about to enter the UI-active state.

Syntax


HRESULT RequestUIActivate();

Parameters

This method has no parameters.

Return value

This method returns S_OK if the object can continue the activation process and call IOleInPlaceSite::OnUIActivate. Other possible return values include the following.

Return codeDescription
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.

E_FAIL

The operation failed.

 

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 IOleInPlaceSiteEx::RequestUIActivate, the container handles data validation and fires Enter and Exit events from IOleInPlaceSite::OnUIActivate.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IOleInPlaceSiteEx is defined as 9C2CAD80-3424-11CF-B670-00AA004CD6D8

See also

IOleInPlaceSiteEx
IOleInPlaceSite::OnUIActivate
IOleInPlaceSite::OnUIDeactivate

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.