|
IOleInPlaceObject::InPlaceDeactivate
Deactivates an active in-place object and discards the object's undo state.
HRESULT InPlaceDeactivate();
Return Values
S_OK
The object was successfully deactivated.
E_UNEXPECTED
An unexpected error occurred.
Comments
Notes to Callers
This method is called by an active object's immediate container to deactivate
the active object and discard its undo state.
Notes to Implementors
On return from IOleInPlaceObject::InPlaceDeactivate, the object discards its undo state. The object application should not shut
down immediately after this call. Instead, it should wait for an explicit call
to IOleObject::Close or for the object's reference count to reach zero.
Before deactivating, the object application should give the container a chance
to put its user interface back on the frame window by calling IOleInPlaceSite::OnUIDeactivate.
If the in-place user interface is still visible during the call to InPlaceDeactivate, the object application should call its own IOleInPlaceObject::UIDeactivate method to hide the user interface. The in-place user interface can be
optionally destroyed during calls to IOleInPlaceObject::UIDeactivate and IOleInPlaceObject::InPlaceDeactivate. But if the user interface has not already been destroyed when the container
calls IOleObject::Close, then it must be destroyed during the call to IOleObject::Close.
During the call to IOleObject::Close, the object should check to see whether it is still active in place. If so,
it should call InPlaceDeactivate.
See Also
IOleInPlaceSite::OnInPlaceDeactivate, IOleInPlaceSite::OnUIDeactivate, 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
|
