IInkDisp::ClipboardPaste

4/8/2010

Copies the IDataObject from the Clipboard to the IInkDisp object.

Syntax

HRESULT ClipboardPaste (
  [in, optional, defaultvalue(0)] long x,
  [in, optional, defaultvalue(0)] long y,
  [in, optional, defaultvalue(0)] IDataObject* dataObject,
  [out,retval] IInkStrokes** Strokes
);

Parameters

  • x
    [in, optional] Specifies the x–coordinate to paste to in ink space coordinates. The default value is 0.
  • y
    [in, optional] Specifies the y–coordinate to paste to in ink space coordinates. The default value is 0.
  • dataObject
    [in, optional] Specifies the IDataObject to be used. To paste from the Clipboard, set to NULL. The default value is a NULL pointer.

Return Value

  • S_OK
    Success.
  • E_POINTER
    A parameter contained an invalid pointer.
  • E_INK_EXCEPTION
    An exception occurred inside the method.

Remarks

An error is returned if an unexpected error occurs while accessing the Clipboard. If no error occurs but the Clipboard does not contain a format that can be pasted into ink—ink serialized format (ISF) then NULL is returned and no exception is thrown. For more information about the Clipboard, see Clipboards Reference.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also

Concepts

Windows Mobile Ink Reference