InkAnalyzer.AddStrokes メソッド (StrokeCollection, Int32)

2008-10-28

StrokeCollection を InkAnalyzer に追加し、特定のロケール識別子を各ストロークに割り当てます。

名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.dll 内)

構文

'宣言
Public Function AddStrokes ( _
    strokesToAdd As StrokeCollection, _
    languageId As Integer _
) As ContextNode
'使用
Dim instance As InkAnalyzer
Dim strokesToAdd As StrokeCollection
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd, _
    languageId)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

public:
ContextNode^ AddStrokes(
    StrokeCollection^ strokesToAdd, 
    int languageId
)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

public function AddStrokes(
    strokesToAdd : StrokeCollection, 
    languageId : int
) : ContextNode

パラメータ

strokesToAdd
型 : System.Windows.Ink.StrokeCollection
InkAnalyzer に追加される StrokeCollection。

languageId
型 : System.Int32
strokesToAdd コレクションのストロークに割り当てられるロケール識別子。

戻り値

型 : System.Windows.Ink.ContextNode
strokesToAdd が追加された ContextNode。

解説

InkAnalyzer は、StrokeCollection を RootNode プロパティの SubNodes コレクション内の UnclassifiedInkNode に追加します。StrokeCollection コレクション strokesToAdd の各ストロークにロケール識別子 languageId を割り当て、同じロケール識別子のストロークを格納する最初の UnclassifiedInkNode に追加します。そのような UnclassifiedInkNode が存在しない場合、新しい UnclassifiedInkNode が作成され、strokesToAdd が新しい UnclassifiedInkNode に追加されます。

このメソッドは、DirtyRegion を、領域の現在の値と追加されたストロークの境界ボックスの結合に拡張します。

いずれかのストロークが既に InkAnalyzer に結合されている場合、InkAnalyzer は例外をスローします。

例

次の例では、新しい InkAnalyzer を作成し、StrokesChanged イベントハンドラを、theInkCanvas という名前の InkCanvas の 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);
    }
}