IOleWindow interface (oleidl.h)
The IOleWindow interface provides methods that allow an application to obtain the handle to the various windows that participate in in-place activation, and also to enter and exit context-sensitive help mode.
Inheritance
The IOleWindow interface inherits from the IUnknown interface. IOleWindow also has these types of members:
Methods
The IOleWindow interface has these methods.
| IOleWindow::ContextSensitiveHelp Determines whether context-sensitive help mode should be entered during an in-place activation session. |
| IOleWindow::GetWindow Retrieves a handle to one of the windows participating in in-place activation (frame, document, parent, or in-place object window). |
Remarks
Several other in-place activation interfaces are derived from the IOleWindow interface. Containers and objects must implement and use these interfaces in order to support in-place activation. The following table briefly summarizes each of these interfaces.
| Interface | Description |
|---|---|
| IOleWindow | The base interface. Implemented and used by containers and objects to obtain window handles and manage context-sensitive help. This interface is not supported for use across machine boundaries. |
| IOleInPlaceObject | Implemented by objects and used by an object's immediate container to activate and deactivate the object. |
| IOleInPlaceActiveObject | Implemented by objects and used by the top-level container to manipulate the object while it is active. Provides a direct channel of communication between an active object and its frame and document windows. |
| IOleInPlaceUIWindow | Implemented by containers and used by objects to manipulate the container's document window. |
| IOleInPlaceFrame | Implemented by containers and used by objects to control the container's frame window. |
| IOleInPlaceSite | Implemented by containers and used by objects to interact with the in-place client site. |
| IOleInPlaceSiteEx | Implemented by containers and called by objects to optimize activation and deactivation. |
| IOleInPlaceSiteWindowless | Implemented by containers and called by windowless object to obtain services from its container. |
| IOleInPlaceObjectWindowless | Implemented by windowless objects called by containers to support window message processing and drag and drop operations for windowless objects. |
These interfaces can be arranged in three hierarchical levels with various interfaces implemented at each level. Calls that install user-interface menus commands and frame adornments, activate and switch between windows, and dispatch menu and keystrokes take place between the top-level container and the active object. Calls that support activating, deactivating, scrolling, or clipping span the containment hierarchy, with each level performing the correct actions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | oleidl.h |