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 |
|
| Biblioteca |
|