RecognitionResult.ModifyTopAlternate, méthode

Article
11/05/2008

Mise à jour : November 2007

Modifie l'objet RecognitionResult grâce à un objet RecognitionAlternate connu.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub ModifyTopAlternate ( _
    alternate As RecognitionAlternate _
)
'Utilisation
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
)

Paramètres

alternate
Type : Microsoft.Ink.RecognitionAlternate
Objet RecognitionAlternate à utiliser pour modifier l'objet RecognitionResult.

Notes

Par défaut, la propriété TopString de l'objet RecognitionResult correspond à la propriété TopAlternate ; toutefois, vous pouvez utiliser cette méthode pour d'autres propositions de substitution (autres que la meilleure) dans le résultat. Lorsque vous choisissez une proposition (autre que la meilleure), vous choisissez d'abord un chemin d'accès différent via la grille des propositions associée aux résultats.

Pour extraire les objets RecognitionAlternate qui peuvent être utilisés pour modifier l'objet RecognitionResult, appelez la méthode GetAlternatesFromSelection.

La proposition de substitution utilisée dans cette méthode peut être une proposition de mot dans une phrase entière. Par exemple, appeler la méthode ModifyTopAlternate sur une proposition obtenue en appelant GetAlternatesFromSelection (0,5) pour « Hello World » modifie « Hello » et laisse « World » inchangé.

Remarque :
Un appel à la méthode ModifyTopAlternate peut modifier les propriétés TopString et TopAlternate de l'objet RecognitionResult.

Exemples

Cet exemple C# effectue le suivi de l'objet RecognitionResult et de ses objets RecognitionAlternate. L'exemple enregistre les objets RecognitionResult avec les objets Stroke reconnus grâce à la méthode SetResultOnStrokes. L'exemple modifie la propriété TopAlternate de l'objet RecognitionResult selon l'entrée d'utilisateur.

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

Cet exemple Microsoft® Visual Basic® .NET effectue le suivi de l'objet RecognitionResult et de ses objets RecognitionAlternate. L'exemple enregistre les objets RecognitionResult avec les objets Stroke reconnus grâce à la méthode SetResultOnStrokes. L'exemple modifie la propriété TopAlternate de l'objet RecognitionResult selon l'entrée d'utilisateur.

[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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.