Ink.ClipboardCopy-Methode (Rectangle, InkClipboardFormats, InkClipboardModes)

Artikel
11/26/2008

Kopiert die im angegebenen Rechteck enthaltene Strokes-Auflistung in das Clipboard.

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

Syntax

'Declaration
Public Function ClipboardCopy ( _
    copyRectangle As Rectangle, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'Usage
Dim instance As Ink
Dim copyRectangle As Rectangle
Dim formats As InkClipboardFormats
Dim modes As InkClipboardModes
Dim returnValue As IDataObject

returnValue = instance.ClipboardCopy(copyRectangle, _
    formats, modes)

public IDataObject ClipboardCopy(
    Rectangle copyRectangle,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public:
IDataObject^ ClipboardCopy(
    Rectangle copyRectangle, 
    InkClipboardFormats formats, 
    InkClipboardModes modes
)

public IDataObject ClipboardCopy(
    Rectangle copyRectangle,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public function ClipboardCopy(
    copyRectangle : Rectangle, 
    formats : InkClipboardFormats, 
    modes : InkClipboardModes
) : IDataObject

Parameter

copyRectangle
Typ: System.Drawing.Rectangle
Das Rechteck, das die Strokes-Auflistung enthält, die in das Clipboard kopiert werden soll.

formats
Typ: Microsoft.Ink.InkClipboardFormats
Ein Member der InkClipboardFormats-Enumeration, mit dem das Format für das Ink-Objekt angegeben wird. Der Standardwert lautet Default.

modes
Typ: Microsoft.Ink.InkClipboardModes
Ein Member der InkClipboardModes-Enumeration, mit dem der Modus für das Ink-Objekt angegeben wird. Der Standardwert lautet Default.

Rückgabewert

Typ: System.Windows.Forms.IDataObject
Gibt das zu erstellende Datenobjekt zurück. Der Standardwert ist nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic .NET).

Hinweise

Wenn das Rechteck Stroke-Objekte abschneidet, sind die entsprechenden Stroke-Objekte in den kopierten Daten abgeschnitten.

Es kann sinnvoll sein, ein gesamtes Ink-Objekt in das Clipboard zu kopieren, wenn alle Eigenschaften des Ink-Objekts kopiert werden sollen. Rufen Sie die ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes)-Methode unter Angabe von Null (Nothing in Visual Basic .NET) für den strokes-Parameter auf, um ein Ink-Objekt in das Clipboard zu kopieren.

Wenn Sie die ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes)-Methode im InkClipboardModes-Modus verwenden, wird einStroke-Objekt, das in zwei oder mehr Striche aufgeteilt wird, gelöscht, und an seiner Stelle werden neue Striche hinzugefügt.

Ink.InkDeleted-Ereignisse werden auf Grundlage der Indizes der Stroke-Objekte innerhalb der Strokes-Auflistung generiert. Wenn beispielsweise die Stroke-Objekte an den Indizes 0, 1, 2, 3, 5 und 6 gelöscht werden sollen, werden zwei Ereignisse erzeugt. Ein Ereignis wird für die Stroke-Objekte mit den Indizes 0, 1, 2 und 3 generiert; und ein Ereignis wird für die Stroke-Objekte mit den Indizes 5 und 6 generiert. Das heißt, für jeden zusammenhängenden Satz wird ein Ereignis erzeugt. Dies gilt auch für InkAdded-Ereignisse. Allerdings bestimmt hier ein interner Algorithmus die Indizes der neu hinzugefügten Stroke-Objekte in der Strokes-Auflistung und beeinflusst, wie die InkAdded-Ereignisse ausgelöst werden.

Wenn Sie im Ereignishandler die Count-Eigenschaft der Strokes-Auflistung abfragen, dann wird die Gesamtanzahl der Stroke-Objekte zurückgegeben, die während des gesamten Vorgangs hinzugefügt wurden, einschließlich der Stroke-Objekte, die noch keine Ereignisse generiert haben.

Warnung

Rufen Sie die System.Windows.Forms.Clipboard.SetDataObject(System.Object)-Methode des Clipboard-Objekts auf, um potenzielle Speicherverluste zu vermeiden, die aus der Verwendung des InkClipboardModes-Flags resultieren könnten. Dies muss vor der Beendigung der Anwendung geschehen, wenn im letzten Aufruf der ClipboardCopy-Methode das DelayedCopy-Flag in der Enumeration InkClipboardModes verwendet wurde.

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

Beispiele

In diesem C#-Beispiel werden alle Freihandeingaben aus der Rechteck-Struktur mit dem Namen theRectangle in das InkCollector-Objekt theInkCollector im Clipboard kopiert.

try
{
    theInkCollector.Ink.ClipboardCopy(theRectangle,
        InkClipboardFormats.Default, InkClipboardModes.Copy);
}
catch
{
    // Place exception handling code here.
}

In diesem Visual Basic .NET-Beispiel werden alle Freihandeingaben aus der Rechteck-Struktur mit dem Namen theRectangle in das InkCollector-Objekt theInkCollector im Clipboard kopiert.

Try
    theInkCollector.Ink.ClipboardCopy(theRectangle,
        InkClipboardFormats.Default, InkClipboardModes.Copy)
Catch
    'Place exception handling code 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.