Método IInkAnalyzer::GetAnalysisHintsByName

Recupera todos os objetos IContextNode da dica de análise anexados ao IInkAnalyzer e que têm o nome especificado.

Sintaxe

HRESULT GetAnalysisHintsByName(
  [in]  BSTR          hintName,
  [out] IContextNodes **ppAnalysisHints
);

hintName [in]: O nome da dica para o qual pesquisar.
ppAnalysisHints [out]: A dica de análise objetos IContextNode no IInkAnalyzer que têm o nome especificado.

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

Cuidado

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

Esse método retornará uma coleção vazia se nenhum desses nós de dica de análise estiver anexado ao IInkAnalyzer.

Um nó de dica de análise é um IContextNode com um tipo de nó de contexto analysisHint (consulte IContextNode::GetType and Context Node Types).

Para adicionar informações de contexto à dica, use IContextNode::AddPropertyData com o parâmetro pPropertyDataId definido como um dos GUIDs (identificadores globalmente exclusivos) nas constantes Propriedades da Dica de Análise .

Para localizar quais valores de propriedade são definidos em um nó de contexto, use IContextNode::GetPropertyDataIds. Para localizar o valor de uma propriedade, use IContextNode::GetPropertyData.

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