Ink.ClipboardCopy 方法 (Strokes, InkClipboardFormats, InkClipboardModes)

將指定的 Strokes 集合複製到剪貼簿。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Function ClipboardCopy ( _
    strokes As Strokes, _
    formats As InkClipboardFormats, _
    modes As InkClipboardModes _
) As IDataObject
'用途
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

參數

strokes
型別：Microsoft.Ink.Strokes
要複製的 Strokes 集合。

formats
型別：Microsoft.Ink.InkClipboardFormats
InkClipboardFormats 列舉型別的成員，指定 Ink 物件的格式。預設值為 Default。

modes
型別：Microsoft.Ink.InkClipboardModes
InkClipboardModes 列舉型別的成員，指定 Ink 物件的模式。預設值為 Default。

傳回值

型別：System.Windows.Forms.IDataObject
傳回要建立的資料物件。預設值是 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Microsoft Visual Basic .NET 中為 Nothing)。

備註

這個方法會複製 Strokes 集合的所有屬性，包含任何 RecognitionResult 屬性。

將 strokes 參數設定為 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Visual Basic .NET 中為 Nothing) 會複製整個 Ink 物件到剪貼簿，包含 CustomStrokes 屬性。此外還會維持 Ink 物件的 CustomStrokes 集合中筆劃的 RecognitionResult 屬性。

如果傳遞的是空白 Strokes 集合，則方法會傳回 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Visual Basic .NET 中為 Nothing)，且不會修改剪貼簿的內容。

警告

為避免使用 InkClipboardModes 旗標造成的潛在記憶體遺漏，請呼叫剪貼簿物件的 System.Windows.Forms.Clipboard.SetDataObject(System.Object) 方法。如果最後的 ClipboardCopy 方法呼叫有在列舉型別 InkClipboardModes 中使用 DelayedCopy 旗標的話，則必須在應用程式結束前完成這項作業。

安全性注意事項：
如果在部分信任的情況下使用，這個方法需要 UIPermissionClipboard.OwnClipboard 權限。如需詳細資訊，請參閱Security And Trust。

範例

這個 C# 範例會使用功能表的事件處理常式，將 InkCollector 物件 (theInkCollector) 的所有筆墨複製到剪貼簿。

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.
    }
}

這個 Visual Basic .NET 範例會使用功能表的事件處理常式，將 InkCollector 物件 (theInkCollector) 的所有筆墨複製到剪貼簿。

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