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
);
Parâmetros
-
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.
Valor retornado
Para obter uma descrição dos valores retornados, consulte Classes e Interfaces – Análise de Tinta os valores retornados.
Comentários
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.
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 |
|
| DLL |
|