IInkDisp::ClipboardCopyWithRectangle method (msinkaut.h)

Copies the IInkStrokeDisp objects that are contained within the known rectangle to the Clipboard.

Syntax

HRESULT ClipboardCopyWithRectangle(
  [in]           IInkRectangle       *Rectangle,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Parameters

[in] Rectangle

Specifies the rectangle that contains the strokes to copy to the Clipboard.

[in, optional] ClipboardFormats

Optional. Specifies the InkClipboardFormats enumeration value of the InkDisp object. The default value is ICF_Default.

[in, optional] ClipboardModes

Optional. Specifies the InkClipboardModes Enumeration value of the InkDisp Class object. The default value is ICB_Default.

[out, retval] DataObject

When this method returns, contains a pointer to the newly create data object.

Return value

This method can return one of these values.

Remarks

If the rectangle clips strokes, those strokes are clipped in the copied data.

It may be useful to copy an InkDisp object to the Clipboard when you only want to copy the properties of the InkDisp object. To copy an InkDisp object to the Clipboard, call the ClipboardCopy method with the strokes parameter set to NULL.

In addition, the InkAdded and InkDeleted events are generated based on the indices of the strokes. For example, if the strokes at indices 0,1,3,5, and 6 are to be deleted, two events will be generated; one for strokes with indices 0123 and one for strokes with indices 5 and 6. That is, one event for each contiguous set.

This also applies to InkAdded events. An internal algorithm determines the indices of the newly added strokes in the stroke collection and this has an impact on how the InkAdded events are fired as described above.

If the strokes count is queried within the event handler, the result is the total number of strokes added by the whole operation including the strokes that have not yet generated events.

Requirements

See also

ClipboardCopy Method

IInkDisp

InkClipboardFormats Enumeration

InkClipboardModes Enumeration

InkDisp Class

InkStrokes Collection