Ink.ExtractStrokes 方法 (Strokes, ExtractFlags)

發行項
10/29/2008

依照指定藉由使用剪下或複製，從 Ink 物件擷取指定的 Stroke 物件，並傳回包含所擷取 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
其中一個 ExtractFlags 值，指定筆墨是剪下還是複製到新的 Ink 物件中。

傳回值

型別：Microsoft.Ink.Ink
傳回包含已擷取之 Strokes 集合的 Ink 物件。

備註

新的 Ink 物件會保留原始 Ink 物件的繪圖屬性 (Attribute)、屬性 (Property) 和座標。

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

範例

在這個範例中，會建立新的 Ink 物件，其中包含 InkOverlay 物件的前兩個 Stroke 物件。因為 ExtractFlags 列舉型別中的 extractionFlags 參數是設定為 CopyFromOriginal 值，所以在原始 Ink 物件中會保留 Strokes 集合。

' 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);
    }
}