Método IInkAnalyzer::CreateAnalysisHint

Adiciona um novo nó de dica de análise com uma área infinita ao IInkAnalyzer.

Sintaxe

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

Parâmetros

ppAnalysisHint [out]

O novo nó de dica de análise.

Valor retornado

Consulte Classes e Interfaces – Análise de Tinta para obter uma descrição dos valores retornados.

Comentários

Cuidado

Para evitar um vazamento de memória, chame IUnknown::Release no ppAnalysisHint quando você não precisar mais usar o objeto.

Para fornecer informações de contexto extras para o IInkAnalyzer, você pode adicionar dicas de análise ao analisador de tinta. As dicas de análise podem melhorar a precisão do reconhecimento. Por exemplo, você pode adicionar informações de factoid e guia para campos em um aplicativo de formulário.

Esse método cria um novo IContextNode com um tipo de nó de contexto AnalysisHint (consulte IContextNode::GetType) e adiciona a nova dica como um subnodo do nó raiz do objeto IInkAnalyzer (consulte IContextNode::GetSubNodes e IInkAnalyzer::GetRootNode Method).

Para adicionar informações de contexto à dica, use IContextNode::AddPropertyData com o parâmetro pPropertyDataId definido como uma das constantes Propriedades da Dica de Análise .

Se uma dica for atribuída a uma área infinita, chamada de dica global, o IInkAnalyzer aplicará o contexto da dica a toda a tinta que não está dentro da área de outra dica. Várias dicas podem ser anexadas a um único IInkAnalyzer. No entanto, apenas uma dica global pode ser anexada a um único analisador de tinta e nenhuma dica não global pode se sobrepor. Para obter mais informações sobre os tipos de informações de contexto que uma dica pode fornecer, consulte Propriedades da Dica de Análise.

Adicionar uma dica de análise não marca a área da dica para reanálise. Para marcar a área dentro da dica de reanálise, use o Método IInkAnalyzer::SetDirtyRegion para definir a região sujo para a união da região sujo atual e da área da dica de análise.

Ao usar dicas para um aplicativo de formulário, o aplicativo deve evitar misturar contexto de texto com tinta nos formulários. Isso significa, por exemplo, que os nomes de campo de texto não devem ser criados na árvore de análise. As dicas são destinadas a associar a tinta a áreas nas páginas; qualquer contexto de texto interfere nessa associação de tinta para dica. A operação de análise pode mesclar a tinta e o contexto de texto na mesma região de escrita, o que impediria que a tinta fosse associada à área de dica.

Para obter mais informações sobre a análise de tinta, consulte Visão geral da análise de tinta.

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

IInkAnalyzer

IContextNode::AddPropertyData

Método IInkAnalyzer::D eleteAnalysisHint

Método IInkAnalyzer::GetAnalysisHints

Método IInkAnalyzer::GetAnalysisHintsByName

Propriedades da dica de análise

Referência de análise de tinta