Ink.ClipboardPaste-Methode (Point, Object)

Artikel
11/26/2008

Fügt das angegebene IDataObject-Objekt am angegebenen Punkt in dieses Ink-Objekt ein.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function ClipboardPaste ( _
    pt As Point, _
    dataObject As Object _
) As Strokes
'Usage
Dim instance As Ink
Dim pt As Point
Dim dataObject As Object
Dim returnValue As Strokes

returnValue = instance.ClipboardPaste(pt, _
    dataObject)

public Strokes ClipboardPaste(
    Point pt,
    Object dataObject
)

public:
Strokes^ ClipboardPaste(
    Point pt, 
    Object^ dataObject
)

public Strokes ClipboardPaste(
    Point pt,
    Object dataObject
)

public function ClipboardPaste(
    pt : Point, 
    dataObject : Object
) : Strokes

Parameter

pt
Typ: System.Drawing.Point
Der Punkt, an dem das Objekt eingefügt werden soll, in Freihandbereichkoordinaten. Der Standardwert lautet {0, 0}.

dataObject
Typ: System.Object
Das System.Windows.Forms.IDataObject, das in dieses Ink-Objekt eingefügt werden soll.

Rückgabewert

Typ: Microsoft.Ink.Strokes
Gibt die Strokes-Auflistung zurück, die in das Ink-Objekt eingefügt wird.

Hinweise

Eine Ausnahme wird ausgelöst, wenn beim Zugriff auf das Clipboard ein unerwarteter Fehler auftritt. Wenn kein Fehler auftritt, das Clipboard jedoch kein Format enthält, das in ein Ink-Objekt eingefügt werden kann (entweder Ink Serialized Format (ISF) oder Textfreihandobjekt (text ink object, tInk)), dann gibt diese Methode nullNULL-Verweis (Nothing in Visual Basic) (Nothingin Microsoft Visual Basic.NET) zurück, und es wird keine Ausnahme ausgelöst.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit ist für diese Methode die AllClipboard-Berechtigung erforderlich. Weitere Informationen finden Sie unter Security and Trust.

Beispiele

In diesem C#-Beispiel wird ein IDataObject-Objekt namens theDataObject bei Position (100, 100) in Freihandbereichkoordinaten in ein InkCollector-Objekt namens theInkCollector eingefügt.

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

In diesem Visual Basic .NET-Beispiel wird ein IDataObject-Objekt namens theDataObject bei Position (100, 100) in Freihandbereichkoordinaten in ein InkCollector-Objekt namens theInkCollector eingefügt.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.