|
IOleInPlaceObject::UIDeactivate
Deactivates and removes the user interface that supports in-place activation.
HRESULT UIDeactivate();
Return Values
S_OK
The in-place UI was deactivated and removed.
E_UNEXPECTED
An unexpected error occurred.
Notes to Callers
This method is called by the object's immediate container when, for example,
the user has clicked in the client area outside the object.
If the container has called IOleInPlaceObject::UIDeactivate, it should later call IOleInPlaceObject::InPlaceDeactivate to properly clean up resources. The container can assume that stopping or
releasing the object cleans up resources if necessary. The object must be prepared
to do so if IOleInPlaceObject::InPlaceDeactivate has not been called. but either IOleInPlaceObject::UIDeactivate or IOleObject::Close has been called.
Notes to Implementors
Resources such as menus and windows can be either cleaned up or kept in a
hidden state until your object is completely deactivated by calls to either IOleInPlaceObject::InPlaceDeactivate or IOleObject::Close. The object application must call IOleInPlaceSite::OnUIDeactivate before doing anything with the composite menus so that the container can
first be detached from the frame window. On deactivating the in-place object's user
interface, the object is left in a ready state so it can be quickly
reactivated. The object stays in this state until the undo state of the document changes.
The container should then call IOleInPlaceObject::InPlaceDeactivate to tell the object to discard its undo state.
See Also
IOleInPlaceObject::InPlaceDeactivate, IOleInPlaceSite::OnUIDeactivate, IOleInPlaceObject::ReactivateAndUndo, IOleObject::Close
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
