Ink.ExtractStrokes メソッド (Strokes)

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

指定された Stroke オブジェクトを Ink オブジェクトから抽出し、抽出された Stroke オブジェクトを含む新しい Ink オブジェクトを返します。

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

構文

'宣言
Public Function ExtractStrokes ( _
    strokes As Strokes _
) As Ink
'使用
Dim instance As Ink
Dim strokes As Strokes
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes)

public Ink ExtractStrokes(
    Strokes strokes
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes
)

public Ink ExtractStrokes(
    Strokes strokes
)

public function ExtractStrokes(
    strokes : Strokes
) : Ink

パラメータ

strokes
型 : Microsoft.Ink.Strokes
抽出する Strokes コレクション。

戻り値

型 : Microsoft.Ink.Ink
抽出された Strokes コレクションを含む Ink オブジェクトを返します。

解説

新しい Ink オブジェクトは、元の Ink オブジェクトの描画属性、プロパティ、および座標を維持します。

このメソッドの既定の動作では、Strokes コレクションが元の Ink オブジェクトから削除されます。Strokes コレクションを元の Ink オブジェクト内に保持し、Ink のコピーを作成するには、extractionFlags パラメータを ExtractFlags 列挙体の CopyFromOriginal 値に設定して、このメソッドの ExtractStrokes または ExtractStrokes オーバーロードを呼び出します。

例

この例では、InkOverlay オブジェクトの最初の 2 つの Stroke オブジェクトを含む新しい Ink オブジェクトが作成されます。抽出された Stroke オブジェクトは、InkOverlay オブジェクトに関連付けられている元の Ink オブジェクトから削除されます。

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to asub a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    If (allStrokes.Count > 2) Then
        Dim temp As Strokes = allStrokes.Ink.CreateStrokes()
        temp.Add(allStrokes(0))
        temp.Add(allStrokes(1))
        Dim newInk As Ink = allStrokes.Ink.ExtractStrokes(temp)
    End If
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    if (allStrokes.Count > 2)
    {
        Strokes temp = allStrokes.Ink.CreateStrokes();
        temp.Add(allStrokes[0]);
        temp.Add(allStrokes[1]);
        Ink newInk = allStrokes.Ink.ExtractStrokes(temp);
    }
}