IOleWindow interface
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.
When to implement
The inherited methods of this interface are implemented by all in-place objects and containers.
When to use
Use this interface to obtain the window handle to the windows associated with in-place activation (frame, document, parent, and in-place object). It is also used to enter and exit context-sensitive help.
Members
The IOleWindow interface inherits from the IUnknown interface. IOleWindow also has these types of members:
Methods
The IOleWindow interface has these methods.
| Method | Description |
|---|---|
| ContextSensitiveHelp |
Determines whether context-sensitive help mode should be entered during an in-place activation session. |
| 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
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IOleWindow is defined as 00000114-0000-0000-C000-000000000046 |
See also