RecognitionResult.ModifyTopAlternate-Methode

Artikel
10/28/2008

Ändert das RecognitionResult-Objekt mit einem bekannten RecognitionAlternate-Objekt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub ModifyTopAlternate ( _
    alternate As RecognitionAlternate _
)
'Usage
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
)

Parameter

alternate
Typ: Microsoft.Ink.RecognitionAlternate
Das RecognitionAlternate-Objekt, das zur Änderung des RecognitionResult-Objekts verwendet werden soll.

Hinweise

Standardmäßig entspricht die TopString-Eigenschaft des RecognitionResult-Objekts der TopAlternate-Eigenschaft. Sie können diese Methode jedoch verwenden, um andere Alternativen als die erste Alternative im Ergebnis zu wählen. Wenn Sie eine andere als die erste Alternative wählen, bedeutet das die Auswahl eines anderen Pfads durch das Gitter der Alternativen, die den Ergebnissen zugeordnet sind.

Um die RecognitionAlternate-Objekte abzurufen, die zum Ändern des RecognitionResult-Objekts verwendet werden können, rufen Sie die GetAlternatesFromSelection-Methode auf.

Die in dieser Methode verwendete Alternative kann eine Wortalternative innerhalb eines ganzen Satzes sein. Wenn Sie beispielsweise die ModifyTopAlternate-Methode für eine Alternative aufrufen, die durch Aufrufen von GetAlternatesFromSelection(0,5) für "Hello World" erzeugt wurde, wird "Hello" geändert und "World" unverändert gelassen.

Hinweis

Ein Aufruf der ModifyTopAlternate-Methode ändert die TopString-Eigenschaft und die TopAlternate-Eigenschaft des RecognitionResult-Objekts.

Beispiele

In diesem C#-Beispiel werden das RecognitionResult-Objekt und seine RecognitionAlternate-Objekte nachverfolgt. In dem Beispiel werden dann die RecognitionResult-Objekte mit den Stroke-Objekten gespeichert, die mithilfe der SetResultOnStrokes-Methode erkannt wurden. Im Beispiel wird schließlich die TopAlternate-Eigenschaft des RecognitionResult-Objekts auf der Grundlage der Benutzereingabe geändert.

[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]);
}

In diesem Microsoft® Visual Basic® .NET-Beispiel werden das RecognitionResult-Objekt und seine RecognitionAlternate-Objekte nachverfolgt. In dem Beispiel werden dann die RecognitionResult-Objekte mit den Stroke-Objekten gespeichert, die mithilfe der SetResultOnStrokes-Methode erkannt wurden. Im Beispiel wird schließlich die TopAlternate-Eigenschaft des RecognitionResult-Objekts auf der Grundlage der Benutzereingabe geändert.

[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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.