InkAnalyzer.AddStroke 메서드 (Stroke, Int32)

아티클
11/04/2008

업데이트: 2007년 11월

InkAnalyzer에 스트로크를 추가하고 스트로크에 특정 로캘 식별자를 할당합니다.

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

구문

‘선언
Public Function AddStroke ( _
    strokeToAdd As Stroke, _
    languageId As Integer _
) As ContextNode
‘사용 방법
Dim instance As InkAnalyzer
Dim strokeToAdd As Stroke
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStroke(strokeToAdd, _
    languageId)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public:
ContextNode^ AddStroke(
    Stroke^ strokeToAdd, 
    int languageId
)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public function AddStroke(
    strokeToAdd : Stroke, 
    languageId : int
) : ContextNode

매개 변수

strokeToAdd
형식: Microsoft.Ink.Stroke
InkAnalyzer 에 추가할 Stroke입니다.

languageId
형식: System.Int32
strokeToAdd에 할당할 로캘 식별자입니다.

반환 값

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

설명

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

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

스트로크가 이미 InkAnalyzer에 연결된 경우 InkAnalyzer에서 예외가 throw됩니다.

예제

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

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

' Create and enable the InkCollector and attach event handlers.
Me.theInkCollector = New Microsoft.Ink.InkCollector(Me.theInkingPanel)
AddHandler Me.theInkCollector.Stroke, AddressOf Me.theInkCollector_Stroke
Me.theInkCollector.Enabled = True

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

// Create and enable the InkCollector and attach event handlers.
this.theInkCollector =
    new Microsoft.Ink.InkCollector(this.theInkingPanel);
this.theInkCollector.Stroke +=
    new Microsoft.Ink.InkCollectorStrokeEventHandler(
        this.theInkCollector_Stroke);
this.theInkCollector.Enabled = true;

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

이 예제에서 theInkCollector_Stroke 이벤트 처리기는 theInkCollector에 추가된 스트로크를 가져와서 theInkAnalyzer에 추가한 다음 theLanguageId라는 특정 로캘 식별자를 할당합니다.

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

    ' Add the new stroke to the InkAnalyzer using a specific language identifier.
    Me.theInkAnalyzer.AddStroke(e.Stroke, Me.theLanguageId)

End Sub 'theInkCollector_Stroke2

/// <summary>
/// The ink collector's Stroke event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkCollector_Stroke2(
    object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Add the new stroke to the InkAnalyzer using a specific
    // language identifier.
    this.theInkAnalyzer.AddStroke(e.Stroke, this.theLanguageId);
}