Metodo RecognitionResult.SetResultOnStrokes

Articolo
10/29/2008

Aggiornamento: novembre 2007

Assegna l'oggetto RecognitionResult all'insieme Strokes utilizzato per generare i risultati.

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

Sintassi

'Dichiarazione
Public Sub SetResultOnStrokes
'Utilizzo
Dim instance As RecognitionResult

instance.SetResultOnStrokes()

public void SetResultOnStrokes()

public:
void SetResultOnStrokes()

public void SetResultOnStrokes()

public function SetResultOnStrokes()

Note

Se i risultati del riconoscimento vengono assegnati automaticamente a ogni insieme Strokes, le prestazioni del sistema ne risentono. Per impostazione predefinita, i risultati non vengono pertanto associati a un insieme Strokes. Per assegnare i risultati a un insieme Strokes, è necessario chiamare il metodo SetResultOnStrokes. Per restituire i risultati del riconoscimento per un insieme Strokes, utilizzare la proprietà RecognitionResult dell'insieme Strokes. Dopo avere assegnato i risultati a un insieme Strokes, è possibile archiviare i tratti in un insieme CustomStrokes. Questi tratti personalizzati, nonché RecognitionResult, possono essere resi persistenti e recuperati per essere utilizzati in un momento successivo.

Esempi

In questo esempio il riconoscimento sincrono viene gestito in risposta a un'azione dell'utente, ad esempio il clic su una voce di menu o su un pulsante. Innanzitutto, l'insieme Strokes di un oggetto RecognizerContext viene assegnato dall'insieme Strokes associato a un oggetto InkOverlay e viene verificato il conteggio dei tratti. Se l'insieme Strokes contiene almeno un oggetto Stroke, il processo di riconoscimento inizia con una chiamata al metodo Recognize. Se il riconoscimento ha esito positivo, il metodo SetResultOnStrokes viene chiamato per associare l'oggetto RecognizerContext all'insieme Strokes corrispondente. L'insieme Strokes viene infine salvato come un insieme CustomStrokes denominato. Viene inoltre salvato l'oggetto RecognitionResult associato.

' assign strokes collection from the collected strokes
Me.mRecognizerContext.Strokes = Me.mInkOverlay.Ink.Strokes
' check stroke count. Recognize() will throw exception if no strokes
If Me.mRecognizerContext.Strokes.Count > 0 Then
    Dim status As RecognitionStatus
    ' perform the recognition
    Dim rResult As RecognitionResult = Me.mRecognizerContext.Recognize(status)
    ' check status
    If RecognitionStatus.NoError = status Then
        ' attach RecognitionResult to the Strokes collection
        rResult.SetResultOnStrokes()
        ' save the strokes collection (with RecognitionResult attached)
        Try
            mInkOverlay.Ink.CustomStrokes.Add("customCollectionName", rResult.Strokes)
        Catch ex As ArgumentException
            ' this exception is raised when the named collection already exists
        End Try
    End If
End If

// assign strokes collection from the collected strokes
this.mRecognizerContext.Strokes = this.mInkOverlay.Ink.Strokes;
// check stroke count. Recognize() will throw exception if no strokes
if (this.mRecognizerContext.Strokes.Count > 0)
{
    RecognitionStatus status;
    // perform the recognition
    RecognitionResult rResult = this.mRecognizerContext.Recognize(out status);
    // check status
    if (RecognitionStatus.NoError == status)
    {
        // attach RecognitionResult to the Strokes collection
        rResult.SetResultOnStrokes();
        // save the strokes collection (with RecognitionResult attached)
        try
        {
            mInkOverlay.Ink.CustomStrokes.Add("customCollectionName", rResult.Strokes);
        }
        catch (ArgumentException)
        {
            // this exception is raised when the named collection already exists
        }
    }
}

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.