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

Artikel
11/26/2008

Kopiert die angegebene Strokes-Auflistung in das Clipboard.

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

Syntax

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

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

public IDataObject ClipboardCopy(
    Strokes strokes,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public:
IDataObject^ ClipboardCopy(
    Strokes^ strokes, 
    InkClipboardFormats formats, 
    InkClipboardModes modes
)

public IDataObject ClipboardCopy(
    Strokes strokes,
    InkClipboardFormats formats,
    InkClipboardModes modes
)

public function ClipboardCopy(
    strokes : Strokes, 
    formats : InkClipboardFormats, 
    modes : InkClipboardModes
) : IDataObject

Parameter

strokes
Typ: Microsoft.Ink.Strokes
Die zu kopierende Strokes-Auflistung.

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

Diese Methode kopiert alle Eigenschaften der Strokes-Auflistung, einschließlich der ggf. vorhandenen RecognitionResult-Eigenschaft.

Wenn der strokes-Parameter auf nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Visual Basic.NET) festgelegt wird, wird das gesamte Ink-Objekt in das Clipboard kopiert, einschließlich der CustomStrokes-Eigenschaft. Außerdem werden die RecognitionResult-Eigenschaften von Strichen in der CustomStrokes-Auflistung des Ink-Objekts beibehalten.

Wenn eine leere Strokes-Auflistung übergeben wird, gibt die Methode nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Visual Basic .NET) zurück, und der Inhalt des Clipboard wird nicht geändert.

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 mit dem Ereignishandler eines Menüs alle Freihandeingaben aus dem InkCollector-Objekt namens theInkCollector in das Clipboard kopiert.

private void menuEditCopyAll_Click(object sender, EventArgs e)
{
    try
    {
        theInkCollector.Ink.ClipboardCopy(theInkCollector.Ink.Strokes,
            InkClipboardFormats.Default, InkClipboardModes.Copy);
    }
    catch
    {
        // Place exception handling code here.
    }
}

In diesem Visual Basic .NET-Beispiel werden mit dem Ereignishandler eines Menüs alle Freihandeingaben aus dem InkCollector-Objekt namens theInkCollector in das Clipboard kopiert.

Private Sub menuEditCopy_Click(Dim sender As Object, Dim e As EventArgs)
    Try
        theInkCollector.Ink.ClipboardCopy(theInkCollector.Ink.Strokes,
            InkClipboardFormats.Default, InkClipboardModes.Copy)
    Catch
        'Place exception handling code here.
    End Try
End Sub

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.