Compartir a través de


Clase InkRecognizerContext

Permite realizar el reconocimiento de entrada de lápiz, recuperar el resultado del reconocimiento y recuperar alternativas. InkRecognizerContext permite que los distintos reconocedores instalados en un sistema usen el reconocimiento de entrada de lápiz para procesar la entrada correctamente.

InkRecognizerContext tiene estos tipos de miembros:

Eventos

La clase InkRecognizerContext tiene estos eventos.

Evento Descripción
Reconocimiento Se produce cuando InkRecognizerContext ha generado resultados del método BackgroundRecognize.
RecognitionWithAlternates Se produce cuando InkRecognizerContext ha generado resultados después de llamar al método BackgroundRecognizeWithAlternates .

Interfaces

La clase InkRecognizerContext define estas interfaces.

Interfaz Descripción
IInkRecognizerContext Este objeto implementa la interfaz COM IInkRecognizerContext .

Métodos

La clase InkRecognizerContext tiene estos métodos.

Método Descripción
BackgroundRecognize Especifica que el reconocedor debe reconocer los trazos asociados y desencadenar un evento Recognition cuando se complete el reconocimiento.
BackgroundRecognizeWithAlternates Especifica que el reconocedor debe reconocer los trazos asociados y desencadenar un evento RecognitionWithAlternates cuando se complete el reconocimiento.
Clon Crea un inkRecognizerContext duplicado.
EndInkInput Finaliza la entrada de lápiz en InkRecognizerContext.
IsStringSupported Indica si el diccionario del sistema, el diccionario de usuario o la lista de palabras contienen una cadena especificada.
Recognize Realiza el reconocimiento en una colección InkStrokes y devuelve resultados de reconocimiento.
StopBackgroundRecognition Finaliza el reconocimiento en segundo plano que se inició con una llamada a BackgroundRecognize o BackgroundRecognizeWithAlternates.

Propiedades

La clase InkRecognizerContext tiene estas propiedades.

Propiedad Tipo de acceso Descripción
CharacterAutoCompletion
Lectura/escritura
Obtiene o establece el modo autocompletar de caracteres, que determina cuándo se reconocen caracteres o palabras.
Factoid
Lectura/escritura
Obtiene o establece el nombre de cadena del factoid utilizado por el objeto InkRecognizerContext .
Guía
Lectura/escritura
Obtiene o establece inkRecognizerGuide que se va a usar para la entrada de lápiz.
PrefixText
Lectura/escritura
Obtiene o establece los caracteres que vienen antes de la colección InkStrokes en el objeto InkRecognizerContext .
RecognitionFlags
Lectura/escritura
Obtiene o establece las marcas que especifican cómo el reconocedor interpreta la entrada de lápiz y determina la cadena de resultado.
Reconocedor
Lectura/escritura
Obtiene o establece el objeto IInkRecognizer utilizado por el objeto InkRecognizerContext .
Trazos
Lectura/escritura
Obtiene o establece la colección InkStrokes asociada al objeto InkRecognizerContext .
SufijoText
Lectura/escritura
Obtiene o establece los caracteres que vienen después de la colección InkStrokes en el objeto InkRecognizerContext .
WordList
Lectura/escritura
Obtiene o establece el objeto InkWordList que se usa para mejorar los resultados del reconocimiento.

Observaciones

Este objeto se puede crear una instancia llamando al método CoCreateInstance en C++.

Hay dos tipos de reconocimiento: fondo (asincrónico) o primer plano (sincrónico). El reconocimiento en segundo plano se inicia mediante una llamada a los métodos BackgroundRecognize o BackgroundRecognizeWithAlternates , se produce en un subproceso en segundo plano e informa de los resultados a la aplicación a través de un mecanismo de eventos. El reconocimiento en primer plano no se devuelve hasta que se completa todo el reconocimiento, lo que hace que los resultados del reconocimiento estén disponibles para el subproceso que realiza la llamada sin escuchar el evento de reconocimiento.

La entrada de lápiz se procesa continuamente en segundo plano. Si se agrega un IInkStrokeDisp a la colección InkStrokes a la que hace referencia InkRecognizerContext , entonces se reconoce inmediatamente el IInkStrokeDisp . Consulte los comentarios en el tema del método EndInkInput para obtener más detalles.

Todo el reconocimiento se produce a través de un contexto de reconocedor. El contexto define la configuración de una sola sesión de reconocimiento. Recibe la entrada de lápiz que se debe reconocer y define las restricciones en la entrada de lápiz y en la salida del reconocimiento. Las restricciones que se pueden establecer en el contexto incluyen el idioma, el diccionario y la gramática que se usa.

Nota

Establecer propiedades distintas de las propiedades Strokes o CharacterAutoCompletion solo se realiza correctamente si la colección InkStrokes es NULL. Debe establecer las demás propiedades antes de adjuntar la colección InkStrokes a InkRecognizerContext, o bien debe establecer la colección InkStrokes en NULL y, a continuación, establecer las demás propiedades. Si establece la colección InkStrokes en NULL y, a continuación, establece las demás propiedades, es posible que tenga que volver a adjuntar la colección InkStrokes. Esto se debe a que el reconocimiento se inicia justo después de asignar InkStrokes a InkRecognizerContext. Cuando se realiza una llamada al método Recognize [Clase InkRecognizeContext] o BackgroundRecognize, es posible que los resultados de la llamada ya estén disponibles.

Para mejorar el rendimiento de la aplicación, elimine el objeto InkRecognizerContext cuando ya no sea necesario.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible
No se admite ninguno
Encabezado
Msinkaut.h (también requiere Msinkaut_i.c)
Biblioteca
InkObj.dll

Vea también

IInkRecognizer (Interfaz)

InkStrokes (colección)