RecognitionResult.ModifyTopAlternate 메서드

아티클
11/04/2008

업데이트: 2007년 11월

알려진 RecognitionAlternate 개체를 사용하여 RecognitionResult 개체를 수정합니다.

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

구문

‘선언
Public Sub ModifyTopAlternate ( _
    alternate As RecognitionAlternate _
)
‘사용 방법
Dim instance As RecognitionResult
Dim alternate As RecognitionAlternate

instance.ModifyTopAlternate(alternate)

public void ModifyTopAlternate(
    RecognitionAlternate alternate
)

public:
void ModifyTopAlternate(
    RecognitionAlternate^ alternate
)

public void ModifyTopAlternate(
    RecognitionAlternate alternate
)

public function ModifyTopAlternate(
    alternate : RecognitionAlternate
)

매개 변수

alternate
형식: Microsoft.Ink.RecognitionAlternate
RecognitionResult 개체를 수정하는 데 사용할 RecognitionAlternate 개체입니다.

설명

기본적으로 RecognitionResult 개체의 TopString 속성은 TopAlternate 속성에 해당하지만 이 메서드를 사용하면 결과에서 최상위 대체 항목 이외의 대체 항목을 사용할 수 있습니다. 최상위 대체 항목 이외의 대체 항목을 선택하면 결과에 연결된 대체 항목의 격자를 통해 다른 경로가 선택됩니다.

RecognitionResult 개체를 수정하는 데 사용할 수 있는 RecognitionAlternate 개체를 검색하려면 GetAlternatesFromSelection 메서드를 호출합니다.

이 메서드에 사용되는 대체 항목은 전체 문장 내의 단어 대체 항목일 수 있습니다. 예를 들어 "Hello World"에 대해 GetAlternatesFromSelection(0,5)을 호출하여 가져온 대체 항목에 대해 ModifyTopAlternate 메서드를 호출하면 "Hello"가 변경되고 "World"는 그대로 유지됩니다.

참고

ModifyTopAlternate 메서드를 호출하면 RecognitionResult 개체의 TopString 및 TopAlternate 속성이 수정될 수 있습니다.

예제

이 C# 예제에서는 RecognitionResult 개체와 해당 RecognitionAlternate 개체를 추적합니다. 그런 다음 SetResultOnStrokes 메서드를 사용하여 인식한 Stroke 개체와 함께 RecognitionResult 개체를 저장합니다. 마지막으로 사용자 입력에 따라 RecognitionResult 개체의 TopAlternate 속성을 수정합니다.

[C#]

// Declarations...
InkCollector theInkCollector;
Strokes theStrokes;
RecognizerContext theRecognizerContext;
RecognitionResult theRecognitionResult;

// Initialization...

// Initialize the recognizer's strokes
// and assign them to the context.
theStrokes = theInkCollector.Ink.Strokes;
theRecognizerContext = new RecognizerContext();
theRecognizerContext.Strokes = theStrokes;

// Install event handlers.
theRecognizerContext.RecognitionWithAlternates +=
    new RecognizerContextRecognitionWithAlternatesEventHandler(
        RecognitionWithAlternates_Event);

//...

// Recognition Event Handler
private void RecognitionWithAlternates_Event(
    object sender,
    RecognizerContextRecognitionWithAlternatesEventArgs e)
{
    // Save the RecognitionResult, and copy it to the strokes
    theRecognitionResult = e.Result;
    theRecognitionResult.SetResultOnStrokes();
}

// Modify the TopAlternate of the result
private void buttonAlt2_Click(object sender, System.EventArgs e)
{
    RecognitionAlternates theRecognitionAlternates =
        theRecognitionResult.GetAlternatesFromSelection(0, -1);
    theRecognitionResult.ModifyTopAlternate(theRecognitionAlternates[2]);
}

이 Microsoft® Visual Basic® .NET 예제에서는 RecognitionResult 개체와 해당 RecognitionAlternate 개체를 추적합니다. 그런 다음 SetResultOnStrokes 메서드를 사용하여 인식한 Stroke 개체와 함께 RecognitionResult 개체를 저장합니다. 마지막으로 사용자 입력에 따라 RecognitionResult 개체의 TopAlternate 속성을 수정합니다.

[Visual Basic]

'Declarations...
Dim theInkCollector As InkCollector
Dim theStrokes As Strokes
Dim theRecognizerContext As RecognizerContext
Dim theRecognitionResult As RecognitionResult

'Initialization...

'Initialize the recognizer's strokes
'and assign them to the context.
theStrokes = theInkCollector.Ink.Strokes
theRecognizerContext = new RecognizerContext()
theRecognizerContext.Strokes = theStrokes

'Install event handlers.
AddHandler theRecognizerContext.RecognitionWithAlternates, _
AddressOf RecognitionWithAlternates_Event

'...

'Recognition Event Handler
Private Sub RecognitionWithAlternates_Event( _
ByVal sender As Object, _
ByVal e As RecognizerContextRecognitionWithAlternatesEventArgs)
    'Save the RecognitionResult, and copy it to the strokes.
    theRecognitionResult = e.Result
    theRecognitionResult.SetResultOnStrokes()
End Sub

'Modify the TopAlternate of the result
Private Sub ButtonAlt2_Click(object sender, System.EventArgs e) _
Handles ButtonAlt2.Click
    RecognitionAlternates theRecognitionAlternates =
        theRecognitionResult.GetAlternatesFromSelection(0, -1)
    theRecognitionResult.ModifyTopAlternate(theRecognitionAlternates(2))
End Sub