Compartir a través de


RecognizerContext.EndInkInput (Método)

Actualización: noviembre 2007

Finaliza la introducción de entradas manuscritas en el objeto RecognizerContext.

Espacio de nombres:  Microsoft.Ink
Ensamblado:  Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub EndInkInput
'Uso
Dim instance As RecognizerContext

instance.EndInkInput()
public void EndInkInput()
public:
void EndInkInput()
public void EndInkInput()
public function EndInkInput()

Comentarios

Después de llamar a este método, no puede agregar objetos Stroke al objeto RecognizerContext.

El reconocimiento parcial es la capacidad del reconocedor a los resultados devueltos incluso si la aplicación no ha llamado al método EndInkInput, que señala a la aplicación que se han escrito todas las entradas manuscritas. El reconocimiento parcial sólo se produce si el reconocedor puede determinar que se han escrito todas las entradas manuscritas antes de una llamada a EndInkInput y no todos los reconocedores admiten esta característica. Los reconocedores que no admiten el reconocimiento parcial no devuelven ningún resultado hasta que se llama la método EndInkInput.

El reconocimiento incremental es la capacidad del reconocedor de procesar sólo una parte pequeña de la entrada manuscrita que se le ha pasado y se devolver un resultado. Por ejemplo, supongamos que una aplicación contiene cinco líneas de entradas manuscritas y usa un reconocedor de alfabeto latino. El reconocedor puede procesar a la vez solamente una línea y devolver un resultado. Este proceso se usa en el bucle inactivo del subproceso del procesamiento en segundo plano.

Si es el de reconocedor admite el reconocimiento parcial, puede devolver un resultado incluso si no se ha llamado al método EndInkInput.

Nota

Los resultados derivados del reconocimiento parcial pueden ser diferentes de los resultados que se obtienen si se llama al método EndInkInput. El uso del reconocimiento parcial no requiere que el reconocedor devuelva resultados de todas las entradas manuscritas. La pérdida del contexto de algunas entradas manuscritas puede afectar al reconocimiento de forma negativa.

Nota

En Windows Vista y en versiones posteriores, este método queda obsoleto para los reconocedores de idiomas occidentales.

Ejemplos

En este ejemplo de C# se muestra un controlador del evento Click de un control de botón, buttonSubmit_Click, que reconoce la entrada manuscrita válida en la colección Strokes asignada a RecognizerContext, theRecognizerContext (declarada en un ámbito contenedor) y lo muestra en un cuadro de texto si no se produce ningún error.

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 = "";
}

En este ejemplo de Microsoft Visual Basic® .NET se muestra un controlador del evento Click de un control de botón, buttonSubmit_Click, que reconoce la entrada manuscrita válida en la colección Strokes asignada a RecognizerContext, theRecognizerContext (declarada en un ámbito contenedor) y lo muestra en un cuadro de texto si no se produce ningún error.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

RecognizerContext (Clase)

RecognizerContext (Miembros)

Microsoft.Ink (Espacio de nombres)