Metodo RecognizerContext.EndInkInput

Articolo
10/29/2008

Aggiornamento: novembre 2007

Termina l'input penna all'oggetto RecognizerContext.

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

Sintassi

'Dichiarazione
Public Sub EndInkInput
'Utilizzo
Dim instance As RecognizerContext

instance.EndInkInput()

public void EndInkInput()

public:
void EndInkInput()

public void EndInkInput()

public function EndInkInput()

Note

Dopo aver chiamato questo metodo, non è possibile aggiungere oggetti Stroke all'oggetto RecognizerContext.

Attraverso il riconoscimento parziale, il sistema di riconoscimento restituisce risultati anche se l'applicazione non ha chiamato il metodo EndInkInput che segnala all'applicazione che è stato immesso tutto l'input penna. Il riconoscimento parziale si verifica solo se il sistema di riconoscimento può determinare che l'input penna è stato immesso prima di una chiamata all'oggetto EndInkInput, tuttavia non tutti i sistemi di riconoscimento supportano questa funzionalità. I sistemi di riconoscimento che non supportano il riconoscimento parziale non restituiscono nessun risultato finché non viene chiamato l'oggetto EndInkInput.

Attraverso il riconoscimento incrementale, il sistema di riconoscimento elabora solo una piccola parte dell'input penna passato e restituisce un risultato. Ad esempio, si consideri che un'applicazione contiene cinque righe di input penna e utilizza un sistema di riconoscimento dei caratteri latini. Il sistema di riconoscimento può elaborare solo un riga per volta e restituire un risultato. Questo processo viene utilizzato nel ciclo inattivo del thread di elaborazione in background.

Se il sistema di riconoscimento supporta il riconoscimento parziale, può restituire un risultato anche se non è stato chiamato il metodo EndInkInput.

Nota

I risultati che derivano dal riconoscimento parziale possono essere diversi dai risultati derivanti da una chiamata all'oggetto EndInkInput. Tramite il riconoscimento parziale, il sistema di riconoscimento non deve restituire risultati per tutto l'input penna. L'eventuale perdita del contesto di alcuni input penna può influire negativamente sul riconoscimento.

Nota

In Windows Vista e nelle versioni più recenti, questo metodo risulta obsoleto per i sistemi di riconoscimento delle lingue occidentali.

Esempi

In questo esempio di C# viene mostrato un gestore eventi per l'evento Click di un controllo pulsante, buttonSubmit_Click, che riconosce l'input penna valido nell'insieme Strokes assegnato all'oggetto RecognizerContext, theRecognizerContext (dichiarato in un ambito contenitore) e, se non si verificano errori, tale gestore viene visualizzato in una casella di testo.

private void buttonSubmit_Click(object sender, System.EventArgs e)
{
    theRecognizerContext.EndInkInput();
    RecognitionStatus theRecognitionStatus;
    theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
    if (RecognitionStatus.NoError == theRecognitionStatus)
        theTextBox.Text = theRecognitionResult.TopString;
    else
        // Handle the error cases here...
        theTextBox.Text = "";
}

In questo esempio di Microsoft Visual Basic® .NET viene mostrato un gestore eventi per l'evento Click di un controllo pulsante, buttonSubmit_Click, che riconosce l'input penna valido nell'insieme Strokes assegnato all'oggetto RecognizerContext, theRecognizerContext (dichiarato in un ambito contenitore) e, se non si verificano errori, tale gestore viene visualizzato in una casella di testo.

Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
    theRecognizerContext.EndInkInput()
    Dim theRecognitionStatus As RecognitionStatus
    theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
    If RecognitionStatus.NoError = theRecognitionStatus Then
        RichTextBox1.Text = theRecognitionResult.TopString
    Else
        'Handle the error conditions here.
        RichTextBox1.Text = ""
    End If
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.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

RecognizerContext Classe

Membri RecognizerContext

Spazio dei nomi Microsoft.Ink

Condividi tramite