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

项目
11/04/2008

将指定的 Strokes 集合复制到 Clipboard。

命名空间： 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 对象复制到 Clipboard，包括 CustomStrokes 属性。此外，将保持 Ink 对象的 CustomStrokes 集合中的笔画的 RecognitionResult 属性。

如果传递空 Strokes 集合，则该方法返回 nullnull 引用（在 Visual Basic 中为 Nothing）（在 Visual Basic.NET 中为 Nothing），并且不修改 Clipboard 的内容。

警告

为避免因使用 InkClipboardModes 标志可能导致的内存泄漏，请调用 Clipboard 对象的 System.Windows.Forms.Clipboard.SetDataObject(System.Object) 方法。如果上一次调用 ClipboardCopy 方法时使用了枚举 InkClipboardModes 中的 DelayedCopy 标志，则必须在应用程序退出前完成此操作。

安全说明：
如果在部分信任环境下使用，此方法需要 UIPermissionClipboard.OwnClipboard 权限。有关更多信息，请参见Security And Trust。

示例

此 C# 示例使用菜单的事件处理程序将所有墨迹从 InkCollector 对象 theInkCollector 复制到 Clipboard。

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 复制到 Clipboard。

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