Ink.ClipboardCopy メソッド (Strokes, InkClipboardFormats, InkClipboardModes)

2008-10-28

指定した 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
Ink オブジェクトの形式を指定する InkClipboardFormats 列挙体のメンバ。既定値は Default です。

modes
型 : Microsoft.Ink.InkClipboardModes
Ink オブジェクトのモードを指定する InkClipboardModes 列挙体のメンバ。既定値は Default です。

戻り値

型 : System.Windows.Forms.IDataObject
作成されるデータオブジェクトを返します。既定値は nullnull 参照 (Visual Basic では Nothing) (Microsoft Visual Basic .NET の場合は Nothing) です。

解説

このメソッドでは、RecognitionResult を含む、Strokes コレクションのすべてのプロパティをコピーします。

strokes パラメータを nullnull 参照 (Visual Basic では Nothing) (Visual Basic.NET の場合は Nothing) に設定すると、CustomStrokes プロパティも含め、Ink オブジェクト全体が Clipboard にコピーされます。また、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 フラグを使用した場合は、アプリケーションを終了する前に呼び出す必要があります。

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