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
• Interfaces
• Métodos
• Propiedades

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)