Description
An IDataObject that exposes the current display
-
Property type
-
An Unknown object.
-
Syntax
-
object.DataObject
The DataObject Property syntax has these parts:
|
| object | An expression evaluating to an object of type McDisplay. |
Remarks
When GetData is called on this interface, the current display is rendered in the requested format. The returned IDataObject is owned by the McDisplay interface. This property would be the way to get an IDataObject for use with Drag and Drop.
Currently only RegisterClipboardFormat("%McDisplay:IQL~McDisplay% Image Aoi"), RegisterClipboardFormat("%McDisplay:IQL~McDisplay% %Image Display:IQL~Image Display% Area"), CF_ENHMETAFILE and CF_DIB, are supported for the CLIPBOARDFORMAT cfFormat FORMATETC field (see Notes); they are enumerated in that order for IDataObject.EnumFormatEtc.
A QueryInterface for IID_IDataObject will also yield this property.
On access the McDisplay's live IDataObject is returned. You must release this returned object before the McDisplay can be fully released.
Notes
When supplying a FORMATETC structure for IDataObject.GetData or QueryGetData, only the cfFormat field, and optionally the tymed field, are significant for determining if the requested format is available. If the tymed field is TYMED_NULL (0) then an available format with any tymed will match.
The FORMATETC DVTARGETDEVICE* ptd field is significant only when GetData is called for a CF_ENHMETAFILE cfFormat, where it is used to create the reference device context for drawing the metafile; otherwise, ptd should be set to NULL. The dwAspect field should be set to DVASPECT_CONTENT (1) and the lindex field should be set to -1.