InkAnalyzer.AddStrokes 메서드 (Strokes)

아티클
11/04/2008

업데이트: 2007년 11월

InkAnalyzer에 스트로크 컬렉션을 추가하고 각 스트로크에 활성 입력 스레드의 로캘 식별자를 할당합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink.Analysis(Microsoft.Ink.Analysis.dll)

구문

‘선언
Public Function AddStrokes ( _
    strokesToAdd As Strokes _
) As ContextNode
‘사용 방법
Dim instance As InkAnalyzer
Dim strokesToAdd As Strokes
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd)

public ContextNode AddStrokes(
    Strokes strokesToAdd
)

public:
ContextNode^ AddStrokes(
    Strokes^ strokesToAdd
)

public ContextNode AddStrokes(
    Strokes strokesToAdd
)

public function AddStrokes(
    strokesToAdd : Strokes
) : ContextNode

매개 변수

strokesToAdd
형식: Microsoft.Ink.Strokes
InkAnalyzer 에 추가할 Strokes입니다.

반환 값

형식: Microsoft.Ink.ContextNode
strokesToAdd가 추가된 ContextNode입니다.

설명

InkAnalyzer는 RootNode 속성의 SubNodes 컬렉션에 있는 UnclassifiedInkNode에 Strokes를 추가합니다. Strokes 컬렉션인 strokesToAdd의 각 스트로크에 활성 입력 스레드의 로캘 식별자가 할당되고, 같은 로캘 식별자를 갖는 스트로크가 들어 있는 첫 번째 UnclassifiedInkNode에 해당 스트로크가 추가됩니다. 이러한 UnclassifiedInkNode가 없으면 새 UnclassifiedInkNode가 만들어지고 새 UnclassifiedInkNode에 strokeToAdd가 추가됩니다.

이 메서드는 DirtyRegion을 영역의 현재 값과 추가된 스트로크의 경계 상자를 합친 영역으로 확장합니다.

InkAnalyzer에 이미 연결된 스트로크가 있으면 InkAnalyzer는 예외를 throw합니다.

예제

이 예제에서는 다음을 수행합니다.

새 Microsoft.Ink.Ink 개체인 theInk를 초기화합니다.
theInk에 Ink.InkAdded 이벤트 처리기인 theInk_InkAdded를 연결합니다.
theInk의 스트로크 데이터를 분석할 수 있는 새 InkAnalyzer인 theInkAnalyzer를 초기화합니다.

' Create the Ink for use with the InkCollector and attach
' event handlers.
Me.theInk = New Microsoft.Ink.Ink()
AddHandler Me.theInk.InkAdded, AddressOf theInk_InkAdded

' Create the InkAnalyzer.
Me.theInkAnalyzer = New Microsoft.Ink.InkAnalyzer(Me.theInk, Me)

// Create the Ink for use with the InkCollector and attach
// event handlers.
this.theInk = new Microsoft.Ink.Ink();
this.theInk.InkAdded +=
    new Microsoft.Ink.StrokesEventHandler(theInk_InkAdded);

// Create the InkAnalyzer.
this.theInkAnalyzer =
    new Microsoft.Ink.InkAnalyzer(this.theInk, this);

이 예제에서 theInk_InkAdded 이벤트 처리기는 theInk에 추가된 스트로크를 가져와서 theInkAnalyzer에 추가합니다.

''' <summary>
''' The ink's InkAdded event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInk_InkAdded( _
    ByVal sender As Object, ByVal e As Microsoft.Ink.StrokesEventArgs)

    ' This event handler is attached to an Ink object.
    Dim theInk As Microsoft.Ink.Ink = DirectCast(sender, Microsoft.Ink.Ink)

    ' Add the new strokes to the InkAnalyzer.
    Me.theInkAnalyzer.AddStrokes(theInk.CreateStrokes(e.StrokeIds))

End Sub 'theInk_InkAdded

/// <summary>
/// The ink's InkAdded event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInk_InkAdded(object sender, Microsoft.Ink.StrokesEventArgs e)
{
    // This event handler is attached to an Ink object.
    Microsoft.Ink.Ink theInk = sender as Microsoft.Ink.Ink;

    // Add the new strokes to the InkAnalyzer.
    this.theInkAnalyzer.AddStrokes(theInk.CreateStrokes(e.StrokeIds));
}