InkAnalyzer.ResultsUpdated 이벤트

아티클
10/28/2008

업데이트: 2007년 11월

최종 분석 단계가 완료되었을 때 발생합니다.

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

구문

‘선언
Public Event ResultsUpdated As ResultsUpdatedEventHandler
‘사용 방법
Dim instance As InkAnalyzer
Dim handler As ResultsUpdatedEventHandler

AddHandler instance.ResultsUpdated, handler

public event ResultsUpdatedEventHandler ResultsUpdated

public:
 event ResultsUpdatedEventHandler^ ResultsUpdated {
    void add (ResultsUpdatedEventHandler^ value);
    void remove (ResultsUpdatedEventHandler^ value);
}

/** @event */
public void add_ResultsUpdated (ResultsUpdatedEventHandler value)
/** @event */
public void remove_ResultsUpdated (ResultsUpdatedEventHandler value)

JScript에서는 이벤트를 지원하지 않습니다.

설명

InkAnalyzer는 최종 분석 단계에 대한 결과를 조정한 후 이 이벤트를 발생시킵니다.

응용 프로그램에서 BackgroundAnalyze를 호출한 경우 이 이벤트는 분석 결과가 준비되었음을 나타냅니다.

응용 프로그램에서 InkAnalyzer의 데이터 구조와 동기화되는 자체 데이터 구조를 유지하는 경우 이 이벤트는 InkAnalyzer에서 해당 분석 단계의 내부 데이터 변경 작업을 마쳤음을 나타냅니다.

잉크 분석기에서 InkAnalyzerStateChanging 이벤트가 발생하면 데이터 구조를 잠가야 합니다. 이 분석 단계에서 데이터 구조를 변경하면 잉크 분석 및 동기화와 관련된 오류가 발생할 수 있습니다. 잉크 분석기에서 IntermediateResultsUpdated 또는 ResultsUpdated 이벤트가 발생할 때 데이터 구조의 잠금을 해제할 수 있습니다.

응용 프로그램 데이터와 InkAnalyzer를 동기화하는 방법에 대한 자세한 내용은 Data Proxy with Ink Analysis을를 참조하십시오.

예제

이 예제에서는 InkAnalyzer인 theInkAnalyzer에 데이터 프록시 이벤트 처리기를 연결하는 AttachDataProxyEventHandlers라는 메서드를 정의합니다.

Private Sub AttachDataProxyEventHandlers() 
    ' If the document model supports on demand data proxy, then add an
    ' event handler for the PopulateContextNode event. This event is raised
    ' when the InkAnalyzer accesses a partially populated ContextNode created
    ' by the document model.
    If Me.theDocumentModel.SupportsOnDemandDataProxy Then
        AddHandler Me.theInkAnalyzer.PopulateContextNode, AddressOf Me.PopulateContextNode
    End If

    ' Add the other data proxy related event handlers. These events are raised
    ' by the InkAnalyzer to communicate ink analysis results to the document model.
    AddHandler Me.theInkAnalyzer.ContextNodeCreated, AddressOf Me.AddContextNode
    AddHandler Me.theInkAnalyzer.ContextNodeDeleting, AddressOf Me.RemoveContextNode
    AddHandler Me.theInkAnalyzer.ContextNodeLinkAdding, AddressOf Me.AddContextNodeLink
    AddHandler Me.theInkAnalyzer.ContextNodeLinkDeleting, AddressOf Me.RemoveContextNodeLink
    AddHandler Me.theInkAnalyzer.ContextNodeMovingToPosition, AddressOf Me.MoveContextNodeToPosition
    AddHandler Me.theInkAnalyzer.ContextNodePropertiesUpdated, AddressOf Me.UpdateContextNodeProperties
    AddHandler Me.theInkAnalyzer.ContextNodeReparenting, AddressOf Me.ReparentContextNode
    AddHandler Me.theInkAnalyzer.InkAnalyzerStateChanging, AddressOf Me.InkAnalyzer_StateChanging
    AddHandler Me.theInkAnalyzer.StrokesReparented, AddressOf Me.ReparentStroke
    AddHandler Me.theInkAnalyzer.IntermediateResultsUpdated, AddressOf Me.ResultsAvailable
    AddHandler Me.theInkAnalyzer.ResultsUpdated, AddressOf Me.ResultsAvailable

End Sub 'AttachDataProxyEventHandlers

        private void AttachDataProxyEventHandlers()
        {
            // If the document model supports on demand data proxy, then add an
            // event handler for the PopulateContextNode event. This event is raised
            // when the InkAnalyzer accesses a partially populated ContextNode created
            // by the document model.
            if (this.theDocumentModel.SupportsOnDemandDataProxy)
            {
                this.theInkAnalyzer.PopulateContextNode +=
                    new Microsoft.Ink.PopulateContextNodeEventHandler(
                        this.PopulateContextNode);
            }

            // Add the other data proxy related event handlers. These events are raised
            // by the InkAnalyzer to communicate ink analysis results to the document model.
            this.theInkAnalyzer.ContextNodeCreated +=
                new Microsoft.Ink.ContextNodeCreatedEventHandler(
                    this.AddContextNode);
            this.theInkAnalyzer.ContextNodeDeleting +=
                new Microsoft.Ink.ContextNodeDeletingEventHandler(
                    this.RemoveContextNode);
            this.theInkAnalyzer.ContextNodeLinkAdding +=
                new Microsoft.Ink.ContextNodeLinkAddingEventHandler(
                    this.AddContextNodeLink);
            this.theInkAnalyzer.ContextNodeLinkDeleting +=
                new Microsoft.Ink.ContextNodeLinkDeletingEventHandler(
                    this.RemoveContextNodeLink);
            this.theInkAnalyzer.ContextNodeMovingToPosition +=
                new Microsoft.Ink.ContextNodeMovingToPositionEventHandler(
                    this.MoveContextNodeToPosition);
            this.theInkAnalyzer.ContextNodePropertiesUpdated +=
                new Microsoft.Ink.ContextNodePropertiesUpdatedEventHandler(
                    this.UpdateContextNodeProperties);
            this.theInkAnalyzer.ContextNodeReparenting +=
                new Microsoft.Ink.ContextNodeReparentingEventHandler(
                    this.ReparentContextNode);
            this.theInkAnalyzer.InkAnalyzerStateChanging +=
                new Microsoft.Ink.InkAnalyzerStateChangingEventHandler(
                    this.InkAnalyzer_StateChanging);
            this.theInkAnalyzer.StrokesReparented +=
                new Microsoft.Ink.StrokesReparentedEventHandler(
                    this.ReparentStrokes);
            this.theInkAnalyzer.IntermediateResultsUpdated +=
                new Microsoft.Ink.ResultsUpdatedEventHandler(
                    this.ResultsAvailable);
            this.theInkAnalyzer.ResultsUpdated +=
                new Microsoft.Ink.ResultsUpdatedEventHandler(
                    this.ResultsAvailable);
        }

다음 예제에서는 IntermediateResultsUpdated 및 ResultsUpdated 이벤트를 처리하는 ResultsAvailable이라는 메서드를 정의합니다. 이벤트 정보는 문서 모델 개체인 theDocumentModel에 전달됩니다.

이 예제에서는 문서 모델의 정의를 제공하거나 문서 모델에서 전달된 정보를 처리하는 방법을 보여 주지 않습니다.

'/ <summary>
'/ Handles the InkAnalyzer.Results and InkAnalyzer.IntermediateResults events.
'/ </summary>
'/ <param name="sender">The source of the event.</param>
'/ <param name="e">The event data.</param>
Private Sub ResultsAvailable( _
    ByVal sender As Object, _
    ByVal e As Microsoft.Ink.ResultsUpdatedEventArgs)
    If e.Status.Successful Then
        Me.theDocumentModel.ResultsAvailable(CType(sender, Microsoft.Ink.InkAnalyzer))
    End If
End Sub 'ResultsAvailable

/// <summary>
/// Handles the InkAnalyzer.Results and InkAnalyzer.IntermediateResults events.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
private void ResultsAvailable(object sender, Microsoft.Ink.ResultsUpdatedEventArgs e)
{
    if (e.Status.Successful)
    {
        this.theDocumentModel.ResultsAvailable((Microsoft.Ink.InkAnalyzer)sender);
    }
}