Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Copies the IDataObject from the Clipboard to the IInkDispobject.

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