Ink.ClipboardCopy-Methode (InkClipboardFormats, InkClipboardModes)

Artikel
10/28/2008

Kopiert das Ink-Objekt in das Clipboard.

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

Syntax

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

returnValue = instance.ClipboardCopy(formats, _
    modes)

public IDataObject ClipboardCopy(
    InkClipboardFormats formats,
    InkClipboardModes modes
)

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

public IDataObject ClipboardCopy(
    InkClipboardFormats formats,
    InkClipboardModes modes
)

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

Parameter

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
Das zu erstellende Datenobjekt. Der Standardwert ist nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic .NET).

Hinweise

Diese Methode kopiert das Ink-Objekt in das Clipboard, einschließlich der CustomStrokes-Eigenschaft. Außerdem wird die RecognitionResult-Eigenschaft von Strichen in der CustomStrokes-Auflistung des Ink-Objekts beibehalten.

Wenn die Strokes-Auflistung des Ink-Objekts leer ist, 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 SetDataObject-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 Click-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(InkClipboardFormats.Default, 
            InkClipboardModes.Copy);    
    }    
    catch
    {
        // Place exception handling code here.
    }
}

In diesem Visual Basic .NET-Beispiel werden mit dem Click-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(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.