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 interface for more information on operations involving windowless objects, such as drawing, drag and drop, and processing window messages.

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.

QuickInfo

  Windows NT: Use version 4.0 or later. New for OC96.
  Windows: Use Windows 95 or later. New for OC96.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IOleInPlaceSiteWindowless