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

將指定矩形包含的 Strokes 集合複製到剪貼簿。

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

語法

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

參數

copyRectangle
型別：System.Drawing.Rectangle
包含要複製到剪貼簿之 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)。

備註

如果矩形會裁剪 Stroke 物件，則在複製的資料中也會裁剪 Stroke 物件。

當您想要複製 Ink 物件的所有屬性時，將整個 Ink 物件複製到剪貼簿可能會很有用。若要複製 Ink 物件到剪貼簿，請呼叫 ClipboardCopy(Strokes, InkClipboardFormats, InkClipboardModes) 方法，並將 strokes 參數設定為 null (在 Visual Basic .NET 中為 Nothing)。

在 InkClipboardModes 模式中使用 ClipboardCopy(Rectangle, InkClipboardFormats, InkClipboardModes) 方法時，會刪除分割為兩個或多個筆劃的 Stroke 物件，並在其位置加入新筆劃。

Ink.InkDeleted 事件的產生，是依據 Strokes 集合內 Stroke 物件的索引。例如，如果要刪除索引為 0、1、2、3、5 和 6 的 Stroke 物件，則會產生兩個事件。一個事件是針對索引 0、1、2 和 3 的 Stroke 物件而產生的，一個事件是針對索引 5 和 6 的 Stroke 物件而產生的。也就是每組連續的索引就會有一個事件。這也適用於 InkAdded 事件，然而，內部的演算法會決定 Strokes 集合中新加入的 Stroke 物件的索引，並會影響到 InkAdded 事件的引發方式。

如果從事件處理常式內查詢 Strokes 集合的 Count 屬性，則結果會是整個作業加入的 Stroke 物件總數，包含尚未產生事件的 Stroke 物件。

警告

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

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

範例

這個 C# 範例會將 Rectangle 結構 (theRectangle) 中所有筆墨複製到 InkCollector 物件 (theInkCollector)，然後再複製到剪貼簿。

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

這個 Visual Basic .NET 範例會將 Rectangle 結構 (theRectangle) 中所有筆墨複製到 InkCollector 物件 (theInkCollector)，然後再複製到剪貼簿。

Try
    theInkCollector.Ink.ClipboardCopy(theRectangle,
        InkClipboardFormats.Default, InkClipboardModes.Copy)
Catch
    'Place exception handling code here.
End Try