Ink.ExtractStrokes 方法 (Strokes, ExtractFlags)

项目
10/28/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 对象。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);
    }
}