Interfaz IInkRecognitionResult (msinkaut.h)

Representa el resultado del reconocimiento. Los resultados de reconocer la entrada manuscrita se devuelven en un objeto IInkRecognitionResult .

Herencia

La interfaz IInkRecognitionResult hereda de la interfaz IUnknown . IInkRecognitionResult también tiene estos tipos de miembros:

Métodos

La interfaz IInkRecognitionResult tiene estos métodos.

IInkRecognitionResult::get_Strokes Obtiene la colección de trazos contenidos en un objeto o que se usan para crear un objeto . (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult::get_TopAlternate Obtiene la alternativa superior del resultado del reconocimiento. (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult::get_TopConfidence Obtiene la alternativa superior del resultado del reconocimiento. (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult::get_TopString Obtiene el texto del resultado de la propiedad TopAlternate.
IInkRecognitionResult::ModifyTopAlternate Cambia la alternativa superior de un resultado de reconocimiento mediante la alternativa especificada.
IInkRecognitionResult::SetResultOnStrokes Asigna los resultados de reconocimiento a los trazos que se usaron para crear los resultados.

Comentarios

Los objetos IInkRecognitionAlternate , o alternativas, se crean a partir del resultado. La mejor alternativa, o superior, es la que se usa de forma predeterminada en el resultado. Sin embargo, puede usar los métodos del objeto IInkRecognitionResult para especificar qué alternativas usar en el resultado.

El rendimiento del sistema puede sufrir si los resultados del reconocimiento se asignan automáticamente a cada colección de trazos. Por lo tanto, de forma predeterminada, los resultados no se adjuntan a una colección de trazos. Debe llamar al método SetResultOnStrokes para asignar resultados a una colección de trazos.

La única manera de conservar los resultados de reconocimiento es llamar a SetResultOnStrokes y, a continuación, agregar esta colección de trazos a la colección CustomStrokes en el objeto InkDisp .

No todos los reconocedores establecen la propiedad TopConfidence . Cuando una aplicación intenta acceder a una propiedad que el reconocedor no establece, se produce una excepción de argumento.

Si define una clase que implementa esta interfaz, la nueva clase no interactuará correctamente con las interfaces de programación de aplicaciones de Tablet PC (API).

Nota Los distintos reconocedores de escritura a mano enviados desde Microsoft tanto en caracteres latinos como en idiomas asiáticos orientales a veces pueden producir el valor Unicode 0xFFFF como resultado del reconocimiento. Esto ocurre cuando el reconocedor no puede coincidir con un fragmento de lápiz con cualquier carácter válido. El punto de código 0xFFFF es UCS-2 válido, pero no se permite en UTF-8. Una aplicación que convierte los resultados de reconocimiento en UTF-8, debe reemplazar 0xFFFF por algún otro punto de código, por ejemplo, 0xFFFD.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h

Consulte también

Propiedad CustomStrokes [Clase InkDisp]

IInkCustomStrokes (Interfaz)

IInkRecognizer (interfaz)

InkDisp (clase)

InkRecognizerContext (clase)

Colección InkStrokes