Ink.ExtractStrokes メソッド (Strokes, ExtractFlags)

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

指定に従って切り取りまたはコピーを行い、指定された Stroke オブジェクトを Ink オブジェクトから抽出し、抽出された Stroke オブジェクトを含む新しい Ink オブジェクトを返します。

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

構文

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

returnValue = instance.ExtractStrokes(strokes, _
    extractionFlags)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    strokes : Strokes, 
    extractionFlags : ExtractFlags
) : Ink

パラメータ

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

extractionFlags
型 : Microsoft.Ink.ExtractFlags
新しい Ink オブジェクトにインクが切り取られるか、またはコピーされるかを指定する ExtractFlags 値の 1 つ。

戻り値

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

解説

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

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

例

この例では、InkOverlay オブジェクトの最初の 2 つの Stroke オブジェクトを含む新しい Ink オブジェクトが作成されます。Strokes コレクションは元の Ink オブジェクト内に保持されます。これは、extractionFlags パラメータが ExtractFlags 列挙体の CopyFromOriginal 値に設定されているためです。

' 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, ExtractFlags.CopyFromOriginal)
    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, ExtractFlags.CopyFromOriginal);
    }
}