Metodo RecognitionResult.ModifyTopAlternate

Articolo
10/29/2008

Aggiornamento: novembre 2007

Modifica l'oggetto RecognitionResult con un oggetto RecognitionAlternate conosciuto.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

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

Parametri

alternate
Tipo: Microsoft.Ink.RecognitionAlternate
Oggetto RecognitionAlternate da utilizzare per modificare l'oggetto RecognitionResult.

Note

Per impostazione predefinita, la proprietà TopString dell'oggetto RecognitionResult corrisponde alla proprietà TopAlternate. È tuttavia possibile utilizzare questo metodo per utilizzare alternative diverse dalla prima alternativa nel risultato. Quando si sceglie un'alternativa diversa dalla prima, si sta essenzialmente scegliendo un percorso diverso attraverso la struttura di alternative associate ai risultati.

Per recuperare gli oggetti RecognitionAlternate che è possibile utilizzare per modificare l'oggetto RecognitionResult, chiamare il metodo GetAlternatesFromSelection.

L'alternativa utilizzata in questo metodo può essere un'alternativa di parola all'interno di un'intera frase. Ad esempio, chiamando il metodo ModifyTopAlternate su un'alternativa ottenuta chiamando GetAlternatesFromSelection (0,5) per "Hello World", si modifica "Hello" e si lascia "World" inalterato.

Nota

Una chiamata al metodo ModifyTopAlternate potrebbe modificare le proprietà TopString e TopAlternate dell'oggetto RecognitionResult.

Esempi

In questo esempio C# si tiene traccia dell'oggetto RecognitionResult e dei relativi oggetti RecognitionAlternate. Nell'esempio vengono salvati gli oggetti RecognitionResult con gli oggetti Stroke riconosciuti tramite il metodo SetResultOnStrokes. Nell'esempio viene infine modificata la proprietà TopAlternate dell'oggetto RecognitionResult in base all'input dell'utente.

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

Nell'esempio Microsoft® Visual Basic® .NET si tiene traccia dell'oggetto RecognitionResult e dei relativi oggetti RecognitionAlternate. Nell'esempio vengono quindi salvati gli oggetti RecognitionResult con gli oggetti Stroke riconosciuti tramite il metodo SetResultOnStrokes. Nell'esempio viene infine modificata la proprietà TopAlternate dell'oggetto RecognitionResult in base all'input dell'utente.

[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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.