InkAnalyzer.RemoveStrokes 方法

项目
11/04/2008

从墨迹分析器移除笔画集合。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink.Analysis（在 Microsoft.Ink.Analysis.dll 中）

语法

声明
Public Sub RemoveStrokes ( _
    strokesToRemove As Strokes _
)
用法
Dim instance As InkAnalyzer
Dim strokesToRemove As Strokes

instance.RemoveStrokes(strokesToRemove)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public:
void RemoveStrokes(
    Strokes^ strokesToRemove
)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public function RemoveStrokes(
    strokesToRemove : Strokes
)

参数

strokesToRemove
类型：Microsoft.Ink.Strokes
要移除的笔画集合。

备注

此方法从 InkAnalyzer 移除 strokesToRemove。

此方法从引用 strokesToRemove 中每个笔画的叶上下文节点移除该笔画。如果该上下文节点不再引用任何笔画，则此方法删除该上下文节点以及不再拥有任何子节点的所有上级节点。

从上下文节点移除笔画后，此方法会更新 DirtyRegion 以包含已移除笔画的边界框。

此方法忽略所有不与墨迹分析器关联的笔画。如果 strokesToRemove 中的笔画都不与墨迹分析器关联，则此方法返回但不更新墨迹分析器。

当 strokesToRemove 为 nullnull 引用（在 Visual Basic 中为 Nothing）时，此方法引发 System.ArgumentNullException。

示例

此示例从墨迹分析器中移除所有与 InkAnalyzer (theInkAnalyzer) 关联的笔画，同时将这些笔画从与 theInkAnalyzer 关联的 Microsoft.Ink.Ink 对象中移除。

' Get all the strokes associated with the ink analyzer.
Dim theStrokes As Microsoft.Ink.Strokes = Me.theInkAnalyzer.RootNode.Strokes

If Nothing IsNot theStrokes Then
    ' Remove the strokes from the analyzer.
    Me.theInkAnalyzer.RemoveStrokes(theStrokes)

    ' Deleted the strokes from the associated Ink object.
    Me.theInkAnalyzer.Ink.DeleteStrokes(theStrokes)
End If

// Get all the strokes associated with the ink analyzer.
Microsoft.Ink.Strokes theStrokes = this.theInkAnalyzer.RootNode.Strokes;

if (null != theStrokes)
{
    // Remove the strokes from the analyzer.
    this.theInkAnalyzer.RemoveStrokes(theStrokes);

    // Deleted the strokes from the associated Ink object.
    this.theInkAnalyzer.Ink.DeleteStrokes(theStrokes);
}