Método IContextNode::Confirm

Modifica o tipo de confirmação, que controla o que o objeto IInkAnalyzer pode alterar sobre o IContextNode.

Sintaxe

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Parâmetros

confirmedType [in]

O ConfirmationType que é aplicado ao nó.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.

Comentários

Use esse método para permitir que o usuário final confirme se o IInkAnalyzer analisou corretamente os traços. Depois que IContextNode::Confirm for chamado, o IInkAnalyzer não alterará os objetos IContextNode para esses traços durante a análise posterior.

Use IContextNode::Confirm quando o usuário confirmou os resultados da análise e não deseja que o IInkAnalyzer altere um IContextNode durante a análise posterior. Por exemplo, se o usuário gravar a palavra "para" e, em seguida, o aplicativo chamar o Método IInkAnalyzer::Analyze, o analisador de tinta gerará um nó InkWord com o valor de "to". Se o usuário adicionar "me" depois de "to" como uma palavra e o aplicativo chamar IInkAnalyzer::Analyze Method novamente, o analisador de tinta poderá remover o nó InkWord anterior e criar um novo nó InkWord com o valor "tome". No entanto, se após a primeira chamada para o Método IInkAnalyzer::Analyze, o aplicativo chamar IContextNode::Confirm no nó InkWord para "to" com o valor ConfirmationTypeNodeTypeAndProperties, antes que o usuário adicione o "me", quando o aplicativo chamar IInkAnalyzer::Analyze Method, o analisador de tinta não removerá ou alterará o nó "para". Em vez disso, o analisador de tinta pode reconhecer dois nós inkWord para "to" e "me".

IContextNode só pode confirmar objetos do tipo InkWord e InkDrawing (consulte Tipos de nó de contexto). IContextNode::Confirm retorna E_INVALIDARG quando o nó não é um nó folha.

Método IInkAnalyzer::RemoveStroke e Método IInkAnalyzer::RemoveStrokes não confirmam nenhum nó do qual eles removem dados de traço.

IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType e IInkAnalyzer::SetStrokeType retornam CORE_E_INVALIDOPERATION se o objeto IContextNode já estiver confirmado.

IContextNode::ReparentStrokeByIdToNode retornará um erro se o nó de origem ou destino for confirmado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	IACom.h (também requer IACom_i.c)
DLL	IACom.dll

Confira também

IContextNode

IContextNode::IsConfirmed

Referência de análise de tinta