IOleInPlaceSite::OnUIDeactivate method

Notifies the container that it should reinstall its user interface and take focus, and whether the object has an undoable state.

Syntax


HRESULT OnUIDeactivate(
  [in]  BOOL fUndoable
);

Parameters

fUndoable [in]

Specifies whether the object can undo changes (TRUE) or not (FALSE).

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
E_UNEXPECTED

An unexpected error has occurred.

 

Remarks

The object indicates whether it can undo changes through the fUndoable flag. If the object can undo changes, the container can (by the user invoking the Edit Undo command) call the IOleInPlaceObject::ReactivateAndUndo method to undo the changes.

Notes to Callers

IOleInPlaceSite::OnUIDeactivate is called by the site's immediate child object when it is deactivating to notify the container that it should reinstall its own user interface components and take focus. The container should wait for the call to IOleInPlaceSite::OnUIDeactivate to complete before fully cleaning up and destroying any composite submenus.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleInPlaceSite is defined as 00000119-0000-0000-C000-000000000046

See also

IOleInPlaceSite
IOleInPlaceObject::ReactivateAndUndo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft