Ink.ClipboardPaste Method

Ink.ClipboardPaste Method

Pastes the specified IDataObject to the specified point in this Ink object.

Definition

Visual Basic .NET	Public Function ClipboardPaste( _ ByVal pt As Point, _ ByVal dataObject As Object _ ) As Strokes
C#	public Strokes ClipboardPaste( Point pt, object dataObject );
Managed C++	public: Strokes* ClipboardPaste( Point *pt, Object *dataObject );

Parameters

pt	System.Drawing.Point. The point to paste to, in ink space coordinates. The default value is {0, 0}.
dataObject	System.Object. The IDataObject to paste into this Ink object.

Return Value

Microsoft.Ink.Strokes. Returns the Strokes collection that is pasted to the Ink object.

Exceptions

ObjectDisposedException : The Ink object is disposed.
ThreadStateException :

Remarks

An exception is thrown 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 an Ink object—either ink serialized format (ISF) or tInk—then this method returns null (Nothing in Microsoft® Visual Basic® .NET) and no exception is thrown.

Security Alert: If using under partial trust, this method requires UIPermissionClipboard.AllClipboard permission. See Security And Trust for more information.

Examples

This C# example pastes an IDataObject , theDataObject, to an InkCollector, theInkCollector, at position (100, 100), in ink space coordinates.

try
{
    theInkCollector.Ink.ClipboardPaste(new Point(100, 100), theDataObject);
}
catch
{
    // Exception handling code goes here.
}

This Visual Basic .NET example pastes an IDataObject , theDataObject, to an InkCollector, theInkCollector, at position (100, 100), in ink space coordinates.

Try
    Dim origin As New Point(100, 100)
    theInkCollector.Ink.ClipboardPaste(origin, theDataObject)
Catch
    'Exception handling code goes here.
End Try

See Also

• ClipboardCopy Method
• Strokes Class