Interfaz IInkAnalyzer

Proporciona acceso al análisis de diseño, la escritura y la clasificación de dibujo, y el reconocimiento de escritura a mano.

Miembros

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

• Métodos

Métodos

La interfaz IInkAnalyzer tiene estos métodos.

Método	Descripción
Anulación	Cancela la operación de análisis actual.
AddStroke	Agrega datos de trazo para un solo trazo al IInkAnalyzer y asigna el identificador de referencia cultural del subproceso de entrada activo al trazo.
AddStrokeForLanguage	Agrega datos de trazo para un solo trazo al IInkAnalyzer y asigna un identificador de referencia cultural específico al trazo.
AddStrokes	Agrega datos de trazo para varios trazos al IInkAnalyzer y asigna el identificador de referencia cultural del subproceso de entrada activo a los trazos.
AddStrokesForLanguage	Agrega datos de trazo para varios trazos al IInkAnalyzer y asigna el identificador de referencia cultural especificado a los trazos.
AddStrokesToCustomRecognizer	Agrega datos de trazo para varios trazos a un nodo de reconocedor personalizado.
AddStrokeToCustomRecognizer	Agrega datos de trazo para un único trazo a un nodo de reconocedor personalizado.
Análisis	Realiza análisis de entrada de lápiz sincrónica.
BackgroundAnalyze	Realiza análisis asincrónicos de entrada de lápiz.
ClearStrokeData	Borra los datos del paquete de trazos del IInkAnalyzer.
CreateAnalysisHint	Agrega un nuevo nodo de sugerencia de análisis con un área infinita al IInkAnalyzer.
CreateContextNodes	Crea un objeto IContextNodes .
CreateCustomRecognizer	Crea un nuevo nodo de reconocedor personalizado para IInkAnalyzer.
DeleteAnalysisHint	Quita una sugerencia de análisis de IInkAnalyzer.
FindInkLeafNodes	Recupera todos los nodos de hoja de lápiz.
FindInkLeafNodesForStrokes	Recupera los nodos de hoja de lápiz que contienen los trazos especificados.
FindLeafNodes	Recupera todos los nodos hoja.
FindNode	Recupera el objeto IContextNode para un identificador único global (GUID) especificado.
FindNodesOfType	Recupera todos los objetos IContextNode del tipo especificado.
FindNodesOfTypeForStrokes	Recupera todos los objetos IContextNode del tipo especificado que contienen los trazos especificados.
FindNodesOfTypeInSubTree	Recupera todos los objetos IContextNode del tipo especificado que son descendientes del objeto IContextNode especificado.
FindNodesWithCallBack	Recupera todos los objetos IContextNode que coinciden con los criterios especificados.
FindNodesWithCallBackInSubTree	Recupera todos los objetos IContextNode que coinciden con los criterios especificados y son descendientes del objeto IContextNode especificado.
GetAlternates	Recupera 10 alternativas de análisis para todas las entradas de lápiz asociadas al IInkAnalyzer.
GetAlternatesForContextNodes	Recupera alternativas de análisis para los nodos de una colección IContextNodes especificada.
GetAlternatesForStrokes	Recupera alternativas de análisis para los trazos con los identificadores de trazo especificados.
GetAnalysisHints	Recupera todos los objetos IContextNode de sugerencia de análisis que están asociados a IInkAnalyzer.
GetAnalysisHintsByName	Recupera todos los objetos IContextNode de sugerencia de análisis que están asociados al IInkAnalyzer y que tienen el nombre especificado.
GetAnalysisModes	Recupera marcas que controlan cómo el IInkAnalyzer realiza el análisis de entrada de lápiz.
GetDirtyRegion	Recupera el área que ha cambiado desde la última operación de análisis.
GetInkAnalysisRecognizersByPriority	Recupera una colección ordenada de objetos IInkAnalysisRecognizer .
GetNodesFromTextRange	Recupera una colección de objetos IContextNode que son relevantes para el intervalo de texto especificado para los nodos de contexto especificados.
GetRecognizedString	Recupera la cadena de mejor resultado de la operación de reconocimiento para todo el árbol de nodos de contexto en IInkAnalyzer.
GetRootNode	Recupera el IContextNode raíz del árbol de contexto del objeto IInkAnalyzer .
GetStrokeLanguageId	Recupera el identificador de configuración regional del trazo especificado.
GetStrokeType	Recupera el tipo del trazo especificado.
GetTextRangeFromNodes	Busca el intervalo de texto en la cadena reconocida que corresponde a una colección de objetos IContextNode .
IsAnalyzing	Recupera un valor que indica si IInkAnalyzer está realizando el análisis de entrada de lápiz.
LoadResults	Carga los resultados de análisis guardados en IInkAnalyzer.
ModifyTopAlternate	Cambia la alternativa superior actual a la alternativa especificada y borra el tipo de confirmación de todos los objetos IContextNode asociados a la alternativa.
ModifyTopAlternateWithConfirmation	Cambia la alternativa superior actual al objeto IAnalysisAlternate especificado.
Reconcile	Determina qué partes de los resultados del análisis han cambiado durante el análisis de entrada de lápiz en segundo plano.
RemoveStroke	Quita el trazo especificado de IInkAnalyzer.
RemoveStrokes	Quita los trazos especificados del IInkAnalyzer.
SaveResults	Guarda todos los resultados de análisis de un IInkAnalyzer.
SaveResultsForNodes	Guarda los resultados de análisis de una colección de nodos de contexto específica asociada a un IInkAnalyzer.
SaveResultsForStrokes	Guarda los resultados de análisis de los trazos especificados asociados a un IInkAnalyzer.
Search	Proporciona una búsqueda de frases aproximada y sin distinción entre mayúsculas y minúsculas para analizar trazos de escritura y trazos de dibujo analizados que tienen tipos reconocidos.
SearchWithLanguageId	Proporciona una búsqueda de frases aproximada y sin distinción entre mayúsculas y minúsculas para analizar trazos de escritura y trazos de dibujo analizados que tienen tipos reconocidos.
SetAnalysisModes	Modifica las marcas que controlan cómo IInkAnalyzer realiza el análisis de entrada de lápiz.
SetDirtyRegion	Modifica el área que ha cambiado desde la última operación de análisis.
SetHighestPriorityInkAnalysisRecognizer	Mueve el IInkAnalysisRecognizer especificado a la primera posición de la lista de reconocedores de entrada de lápiz del objeto IInkAnalyzer .
SetStrokeLanguageId	Cambia el identificador de configuración regional del trazo especificado.
SetStrokesLanguageId	Cambia el identificador de configuración regional de los trazos especificados.
SetStrokesType	Cambia el tipo de los trazos especificados.
SetStrokeType	Cambia el tipo del trazo especificado.
UpdateStrokesData	Novedades los datos de paquete de los trazos especificados.

Comentarios

IInkAnalyzer usa datos de paquetes de trazos para analizar la entrada de lápiz y no interactúa directamente con objetos InkDisp Class o InkStrokes Collection .

Para agregar o quitar trazos al IInkAnalyzer para su análisis, use uno de los métodos siguientes.

• IInkAnalyzer::AddStroke (Método)
• IInkAnalyzer::AddStrokes (Método)
• IInkAnalyzer::RemoveStroke (Método)
• IInkAnalyzer::RemoveStrokes (Método)

Estos métodos actualizan la región desfasada (vea IInkAnalyzer::GetDirtyRegion Method), que es la región para la que se analizan los trazos en la siguiente operación de análisis.

Para analizar la entrada de lápiz, use el método IInkAnalyzer::Analyze oel método IInkAnalyzer::BackgroundAnalyze Method . Durante el análisis, IInkAnalyzer realiza análisis de diseño, clasificación de trazos y reconocimiento de escritura a mano.

Para cambiar la configuración de análisis de diseño y clasificación de trazos, utilice la propiedad IInkAnalyzer::SetAnalysisModes Method .

Durante el análisis, IInkAnalyzer recibe una serie de eventos, incluidos los eventos generados durante el análisis en segundo plano. _IAnalysisProxyEvents admite las características del proxy de datos de IInkAnalyzer. Para más información, consulte Proxy de datos con análisis de entrada de lápiz. Para detener el proceso de análisis desde un controlador de eventos, llame a IInkAnalyzer::Abort Method.

Para modificar el idioma que usa el analizador de tinta para reconocer la escritura a mano, use IInkAnalyzer::SetStrokeLanguageId Method o IInkAnalyzer::SetStrokesLanguageId Method. Para modificar cómo el analizador de lápiz clasifica trazos específicos, use IInkAnalyzer::SetStrokeType Method o IInkAnalyzer::SetStrokesType Method.

IInkAnalyzer carga información para todos los reconocedores de entrada de lápiz instalados. IInkAnalyzer::GetInkAnalysisRecognizersByPriority Method devuelve una colección IInkAnalysisRecognizers que contiene cada IInkAnalysisRecognizer disponible. Si más de un reconocedor de entrada de lápiz admite un lenguaje específico, use IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer (Método) para establecer qué trazos de reconocedor de lápiz controla los trazos de ese idioma.

El uso de sugerencias de análisis puede mejorar la precisión del reconocimiento proporcionando contexto adicional al analizador de entrada de lápiz. La información de contexto adicional puede ayudar al analizador de entrada de lápiz a limitar el número de posibles resultados de reconocimiento. Por ejemplo, puede restringir el ámbito definiendo factoides y palabras esperadas o estructurando la entrada en una guía de reconocimiento. Para obtener más información sobre cómo proporcionar contexto al analizador de lápiz, consulte:

• IInkAnalyzer::CreateAnalysisHint (Método)
• IInkAnalyzer::D eleteAnalysisHint (Método)
• IInkAnalyzer::GetAnalysisHints (Método)
• IInkAnalyzer::GetAnalysisHintsByName (Método)

El analizador de entrada de lápiz representa los resultados de análisis como una cadena o como un árbol de objetos IContextNode . Para acceder a la cadena reconocida, use IInkAnalyzer::GetRecognizedString (Método). Para acceder a la raíz del árbol de nodos de contexto, use IInkAnalyzer::GetRootNode (Método). El analizador de entrada de lápiz tiene los métodos siguientes para buscar nodos de contexto o texto específicos.

• IInkAnalyzer::FindInkLeafNodes (Método)
• IInkAnalyzer::FindInkLeafNodesForStrokes (Método)
• IInkAnalyzer::FindLeafNodes (Método)
• IInkAnalyzer::FindNode (Método)
• IInkAnalyzer::FindNodesOfType (Método)
• IInkAnalyzer::FindNodesOfTypeForStrokes (Método)
• IInkAnalyzer::FindNodesOfTypeInSubTree (Método)
• IInkAnalyzer::FindNodesWithCallBack (Método)
• IInkAnalyzer::FindNodesWithCallBackInSubTree (Método)

Para trabajar con resultados de análisis alternativos, use uno de los métodos siguientes.

• IInkAnalyzer::GetAlternates (Método)
• IInkAnalyzer::GetAlternatesForContextNodes (Método)
• IInkAnalyzer::GetAlternatesForStrokes (Método)
• IInkAnalyzer::ModifyTopAlternate (Método)
• IInkAnalyzer::ModifyTopAlternateWithConfirmation (Método)

Para guardar los resultados del análisis, use uno de los métodos siguientes.

• IInkAnalyzer::SaveResults (Método)
• IInkAnalyzer::SaveResultsForNodes (Método)
• IInkAnalyzer::SaveResultsForStrokes (Método)

Para cargar los resultados guardados, use IInkAnalyzer::LoadResults (Método).

Para obtener más información sobre el uso de IInkAnalyzer para analizar la entrada de lápiz, consulte 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	IACom.h (también requiere IACom_i.c)
Archivo DLL	IACom.dll

Consulte también

AnalysisModes

IAnalysisAlternate

IAnalysisStatus

IContextLink

IContextNode

Referencia de análisis de lápiz