Provides a direct channel of communication between the object and each of the
frame and document windows.
| IOleInPlaceActiveObject *pActiveObject,
||//Points to active in-place object
| LPCOLESTR pszObjName
||//Points to name describing the object
[in] Points to the active in-place object's IOleInPlaceActiveObject
[in] Points to a string containing a name that describes the object an
embedding container can use in composing its window title. It can be NULL if the
object does not require the container to change its window titles. The Microsoft Windows User Interface Design Guide
recommends that containers ignore this parameter and always use their own
name in the title bar.
The method completed successfully.
One or more arguments are invalid.
An unexpected error occurred.
Generally, an embedded object should pass NULL for the pszObjName
parameter (see "Notes to Implementors" below). However, if you are working in
conjunction with a container that does display the name of the in-place active
object in its title bar, then you should compose a string in the following
<object short-type name>
Notes to Callers
IOleInPlaceUIWindow::SetActiveObject is called by the object to establish a direct communication link between
itself and the document and frame windows.
When deactivating, the object calls IOleInPlaceUIWindow::SetActiveObject
, passing NULL for the pActiveObject
An object must
before calling IOleInPlaceFrame::SetMenu
to give the container the pointer to the active object. The container then
uses this pointer in processing IOleInPlaceFrame::SetMenu
and to pass to OleSetMenuDescriptor
Notes to Implementors
The Microsoft Windows User Interface Design Guide
recommends that an in-place container ignore the pszObjName
parameter passed in this method. The guide says "The title bar is not
affected by in-place activation. It always displays the top-level container's name."
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages