Share via


IOleInPlaceSite::OnUIDeactivate

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

HRESULT OnUIDeactivate( 
  BOOL fUndoable  
);

Parameters

  • fUndoable
    [in] Specifies whether the object can undo changes. TRUE if the object can undo, FALSE if it cannot.

Return Value

This method supports the following return values:

Value Description

S_OK

The method completed successfully.

E_UNEXPECTED

The call to the method unexpectedly failed.

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

Header Oleidl.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IOleInPlaceSite