IContextNode::Confirm (método)

Modifica el tipo de confirmación, que controla lo que el objeto IInkAnalyzer puede cambiar sobre IContextNode.

Sintaxis

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Parámetros

confirmedType [in]

Tipo de confirmación que se aplica al nodo.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.

Comentarios

Use este método para permitir que el usuario final confirme que IInkAnalyzer ha analizado correctamente los trazos. Después de llamar a IContextNode::Confirm , IInkAnalyzer no cambiará los objetos IContextNode para esos trazos durante el análisis posterior.

Use IContextNode::Confirm cuando el usuario haya confirmado los resultados del análisis y no quiere que IInkAnalyzer cambie un IContextNode durante el análisis posterior. Por ejemplo, si el usuario escribe la palabra "to" y, a continuación, la aplicación llama al método IInkAnalyzer::Analyze, el analizador de lápiz genera un nodo InkWord con el valor de "to". Si el usuario agrega "me" después de "a" como una palabra y la aplicación llama de nuevo al método IInkAnalyzer::Analyze , el analizador de lápiz puede quitar el nodo InkWord anterior y crear un nuevo nodo InkWord con el valor "tome". Sin embargo, si después de la primera llamada a IInkAnalyzer::Analyze Method, la aplicación llama a IContextNode::Confirm en el nodo InkWord para "to" con el valor ConfirmationTypeNodeTypeAndProperties, antes de que el usuario agregue "me", cuando la aplicación llama al método IInkAnalyzer::Analyze, el analizador de tinta no quita ni cambia el nodo "to". En su lugar, el analizador de lápiz puede reconocer dos nodos inkWord para "to" y "me".

IContextNode solo puede confirmar objetos de tipo InkWord y InkDrawing (vea Tipos de nodo de contexto). IContextNode::Confirm devuelve E_INVALIDARG cuando el nodo no es un nodo hoja.

IInkAnalyzer::RemoveStroke (Método) e IInkAnalyzer::RemoveStrokes (Método) no confirman ningún nodo del que quitan los datos del trazo.

IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType y IInkAnalyzer::SetStrokeTypedevuelven CORE_E_INVALIDOPERATION si el objeto IContextNode ya está confirmado.

IContextNode::ReparentStrokeByIdToNode devuelve un error si se confirma el nodo de origen o de destino.

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

IContextNode

IContextNode::IsConfirmed

Referencia de análisis de lápiz