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

[アーティクル]
10/28/2008

Ink オブジェクトを Clipboard にコピーします。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

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

パラメータ

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) です。

解説

このメソッドでは、CustomStrokes プロパティも含めて、Ink オブジェクトを Clipboard にコピーします。また、Ink オブジェクトの CustomStrokes コレクション内のストロークの RecognitionResult プロパティも維持されます。

Ink オブジェクトの Strokes コレクションが空の場合、このメソッドは nullnull 参照 (Visual Basic では Nothing) (Visual Basic .NET の場合は Nothing) を返し、Clipboard の内容は変更されません。

注意 :
InkClipboardModes フラグを使用した結果発生する可能性のあるメモリリークを回避するために、Clipboard オブジェクトの SetDataObject メソッドを呼び出します。ClipboardCopy メソッドの最後の呼び出しにおいて列挙体 InkClipboardModes で DelayedCopy フラグを使用した場合は、アプリケーションを終了する前に呼び出す必要があります。

InkClipboardModes フラグを使用した結果発生する可能性のあるメモリリークを回避するために、Clipboard オブジェクトの SetDataObject メソッドを呼び出します。ClipboardCopy メソッドの最後の呼び出しにおいて列挙体 InkClipboardModes で DelayedCopy フラグを使用した場合は、アプリケーションを終了する前に呼び出す必要があります。

セキュリティに関するメモ :
このメソッドを部分信頼で使用する場合は、UIPermissionClipboard.OwnClipboard アクセス許可が必要です。詳細については、「Security and Trust」を参照してください。

例

この C# の例ではメニューのクリックイベントハンドラを使用し、すべてのインクを InkCollector オブジェクト theInkCollector から Clipboard にコピーします。

private void menuEditCopyAll_Click(object sender, EventArgs e)
{    
    try
    {
        theInkCollector.Ink.ClipboardCopy(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(InkClipboardFormats.Default, _
            InkClipboardModes.Copy)
    Catch
        'Place exception handling code here.
    End Try
End Sub