Método IInkAnalyzer::CreateAnalysisHint
Agrega un nuevo nodo de sugerencia de análisis con un área infinita al IInkAnalyzer.
Sintaxis
HRESULT CreateAnalysisHint(
[out] IContextNode **ppAnalysisHint
);
Parámetros
-
ppAnalysisHint [out]
-
Nuevo nodo de sugerencia de análisis.
Valor devuelto
Vea Clases e interfaces: análisis de entrada de lápiz para obtener una descripción de los valores devueltos.
Observaciones
Precaución
Para evitar una pérdida de memoria, llame a IUnknown::Release en ppAnalysisHint cuando ya no necesite usar el objeto .
Para proporcionar información de contexto adicional para IInkAnalyzer, puede agregar sugerencias de análisis al analizador de tinta. Las sugerencias de análisis pueden mejorar la precisión del reconocimiento. Por ejemplo, puede agregar información de factoid y guía para los campos de una aplicación de formulario.
Este método crea un nuevo IContextNode con un tipo de nodo de contexto de AnalysisHint (vea IContextNode::GetType) y agrega la nueva sugerencia como un subnodo del nodo raíz del objeto IInkAnalyzer (vea IContextNode::GetSubNodes e IInkAnalyzer::GetRootNode Method).
Para agregar información de contexto a la sugerencia, use IContextNode::AddPropertyData con el parámetro pPropertyDataId establecido en una de las constantes Propiedades de sugerencia de análisis .
Si a una sugerencia se le asigna un área infinita, se le denomina sugerencia global, IInkAnalyzer aplica el contexto de la sugerencia a toda la entrada de lápiz que no está dentro del área de otra sugerencia. Se pueden adjuntar varias sugerencias a un solo IInkAnalyzer. Sin embargo, solo se puede adjuntar una sugerencia global a un único analizador de entrada de lápiz y no se pueden superponer sugerencias no globales. Para obtener más información sobre los tipos de información de contexto que puede proporcionar una sugerencia, vea Propiedades de sugerencias de análisis.
Agregar una sugerencia de análisis no marca el área de la sugerencia para volver a analizar. Para marcar el área dentro de la sugerencia de reanalysis, use IInkAnalyzer::SetDirtyRegion Method para establecer la región suciada en la unión de la región desfasada actual y el área de la sugerencia de análisis.
Al usar sugerencias para una aplicación de formulario, la aplicación debe evitar mezclar el contexto de texto con entrada de lápiz en los formularios. Esto significa, por ejemplo, que los nombres de campo de texto no se deben crear en el árbol de análisis. Las sugerencias están pensadas para asociar la entrada de lápiz a las áreas de las páginas; cualquier contexto de texto interfiere con esta asociación de entrada de lápiz a sugerencia. La operación de análisis puede combinar la entrada de lápiz y el contexto de texto en la misma región de escritura, lo que impediría que la entrada de lápiz se asociara con el área de sugerencias.
Para obtener más información sobre el análisis de entrada de lápiz, vea Información general sobre el análisis de lápiz.
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 |
|
| Archivo DLL |
|