IOleInPlaceObjectWindowless
The IOleInPlaceObjectWindowless
interface enables a windowless object to process window messages and
participate in drag and drop operations. It is derived from and extends the IOleInPlaceObject
interface.
A small
object, such as a control, does not need a window of its own. Instead, it can
rely on its container to dispatch window messages and help the object to participate
in drag and drop operations. The container must implement the IOleInPlaceSiteWindowless
interface. Otherwise, the object must act as a normal compound document object
and create a window when it is activated.
When to Implement
Implement
this interface on an object that can be in place activated without a window.
This interface is derived from IOleInPlaceObject which, in turn, is
derived from IOleWindow.
When to Use
A container
calls the methods in this interface to dispatch window messages to an in-place-active
windowless object and to assist the object in participating in drag and drop
operations. The container must implement a site object with the IOleInPlaceSiteWindowless
interface to support these activities. See the IOleInPlaceSiteWindowless
Methods in VTable Order
IUnknown Methods |
Description |
QueryInterface |
Returns a
pointer to a specified interface. |
AddRef |
Increments
the reference count. |
Release |
Decrements
the reference count. |
IOleWindow Methods |
Description |
GetWindow |
Gets a
window handle. |
ContextSensitiveHelp |
Controls enabling
of context sensitive help. |
IOleInPlaceObject Methods |
Description |
InPlaceDeactivate |
Deactivate
active in-place object. |
UIDeactivate |
Deactivate
and remove UI of active object. |
SetObjectRects |
Portion of
in-place object to be visible. |
ReactivateAndUndo |
Reactivate
previously deactivated object. |
IOleInPlaceObjectWindowless
Methods |
Description |
OnWindowMessage |
Dispatches
a message from the container to a windowless object. |
GetDropTarget |
Supplies
the IDropTarget interface for a windowless object that supports drag
and drop. |
See Also