InkAnalyzer.AddStrokes 方法 (StrokeCollection)

项目
11/04/2008

向 InkAnalyzer 添加指定的 StrokeCollection，并将活动输入线程的区域设置标识符分配给每个笔画。

命名空间： System.Windows.Ink
程序集： IAWinFX（在 IAWinFX.dll 中）

语法

声明
Public Function AddStrokes ( _
    strokesToAdd As StrokeCollection _
) As ContextNode
用法
Dim instance As InkAnalyzer
Dim strokesToAdd As StrokeCollection
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd
)

public:
ContextNode^ AddStrokes(
    StrokeCollection^ strokesToAdd
)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd
)

public function AddStrokes(
    strokesToAdd : StrokeCollection
) : ContextNode

参数

strokesToAdd
类型：System.Windows.Ink.StrokeCollection
要添加到 InkAnalyzer 的 StrokeCollection。

返回值

类型：System.Windows.Ink.ContextNode
strokesToAdd 所添加到的 ContextNode。

备注

InkAnalyzer 将 StrokeCollection 添加到 RootNode 属性的 SubNodes 集合中的一个 UnclassifiedInkNode。为 StrokeCollection 集合 strokesToAdd 中的每个笔画分配活动输入线程的区域设置标识符。该集合中的每个笔画也将添加到包含具有相同区域设置标识符的笔画的第一个 UnclassifiedInkNode。如果不存在这样的 UnclassifiedInkNode，则新建一个 UnclassifiedInkNode，并将 strokesToAdd 添加到新的 UnclassifiedInkNode 中。

此方法将 DirtyRegion 扩展为区域的当前值与所添加笔画的边界框的并集。

如果这些笔画中有任何笔画已经附加到 InkAnalyzer，则 InkAnalyzer 将引发异常。

示例

下面的示例创建一个新的 InkAnalyzer，并将 StrokesChanged 事件处理程序附加到 InkCanvas（名为 theInkCanvas）上的 Strokes 属性。

theInkAnalyzer = New InkAnalyzer()

AddHandler theInkCanvas.Strokes.StrokesChanged, AddressOf Strokes_StrokesChanged

theInkAnalyzer = new InkAnalyzer();

theInkCanvas.Strokes.StrokesChanged += 
    new StrokeCollectionChangedEventHandler(Strokes_StrokesChanged);

下面的示例定义 Strokes_StrokesChanged 事件处理程序；如果笔画已添加到 theInkCanvas，该事件处理程序会将其添加到 theInkAnalyzer 中。如果笔画已从 theInkCanvas 中移除，该事件处理程序也会将其从 theInkAnalyzer 中移除。

' This event occurs whenever a stroke is added, removed, or partially erased
' from the InkCanvas.
Sub Strokes_StrokesChanged(ByVal sender As Object, ByVal e As StrokeCollectionChangedEventArgs) 
    If e.Added.Count > 0 Then
        theInkAnalyzer.AddStrokes(e.Added)
    End If

    If e.Removed.Count > 0 Then
        theInkAnalyzer.RemoveStrokes(e.Removed)
    End If

End Sub 'Strokes_StrokesChanged

// This event occurs whenever a stroke is added, removed, or partially erased
// from the InkCanvas.
void Strokes_StrokesChanged(object sender, StrokeCollectionChangedEventArgs e)
{
    if (e.Added.Count > 0)
    {
        theInkAnalyzer.AddStrokes(e.Added);
    }

    if (e.Removed.Count > 0)
    {
        theInkAnalyzer.RemoveStrokes(e.Removed);
    }
}