Ink.ExtractStrokes 方法 (Strokes)

發行項
10/29/2008

從 Ink 物件擷取指定的 Stroke 物件，並傳回包含所擷取 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 物件的繪圖屬性 (Attribute)、屬性 (Property) 和座標。

這個方法的預設行為是從原始 Ink 物件中移除 Strokes 集合。若要在原始 Ink 物件中保留 Strokes 集合並且複製 Ink，請呼叫這個方法的 ExtractStrokes 或 ExtractStrokes 多載，其中 extractionFlags 參數設為來自 ExtractFlags 列舉型別的 CopyFromOriginal 值。

範例

在這個範例中，會建立新的 Ink 物件，其中包含 InkOverlay 物件的前兩個 Stroke 物件。所擷取的 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);
    }
}