Método IInkAnalyzer::LoadResults

  • Artigo

Carrega os resultados de análise salvos no IInkAnalyzer.

Sintaxe

HRESULT LoadResults(
  [in]          ULONG        ulDataSize,
  [in]          BYTE         *pbSerializedResults,
  [in]          ULONG        ulStrokeIdsCount,
  [in]          LONG         *plOriginalStrokeIds,
  [in]          LONG         *plNewStrokeIds,
  [out, retval] VARIANT_BOOL *pfSuccessful
);

Parâmetros

ulDataSize [in]

O número de bytes em pbSerializedResults.

pbSerializedResults [in]

Os resultados da análise serializada.

ulStrokeIdsCount [in]

O número de identificadores de traço.

plOriginalStrokeIds [in]

A matriz de identificadores de traço originais.

plNewStrokeIds [in]

A matriz de novos identificadores de traço.

pfSuccessful [out, retval]

VARIANT_TRUE se o carregamento foi bem-sucedido; caso contrário, VARIANT_FALSE.

Valor retornado

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

Comentários

Quando o IInkAnalyzer adiciona um IContextNode dos resultados salvos, ele atribui um novo GUID (identificador global exclusivo) ao IContextNode (consulte IContextNode::GetPropertyData e Propriedades do Nó de Contexto).

Esse método adiciona os resultados de análise salvos à árvore IContextNode existente. Para garantir que os resultados combinados sejam ordenados corretamente, adicione a área que contém os nós de contexto carregados à região de sujo do objeto IInkAnalyzer (consulte Método IInkAnalyzer::GetDirtyRegion) e reanalise a tinta.

Os métodos IInkAnalyzer::SaveResults, IInkAnalyzer::SaveResultsForNodes e IInkAnalyzer::SaveResultsForStrokes não salvam os dados do pacote junto com os resultados da análise.

Cada identificador em plOriginalStrokeIds é o identificador de traço para o traço nos resultados da análise salva. Cada identificador em plNewStrokeIds é o novo identificador com o qual substituir o identificador original nos resultados da análise carregada.

Se uma dica de análise salva entrar em conflito com uma dica de análise existente, o IInkAnalyzer não carregará a dica salva, mas carregará o restante dos resultados salvos. No entanto, se o IInkAnalyzer carregar resultados para um traço que está dentro da área de uma dica de análise salva de que o IInkAnalyzer não é carregado, o IInkAnalyzer adiciona a caixa delimitadora do traço à região sujo do objeto IInkAnalyzer. Além disso, se o IInkAnalyzer carregar resultados para um traço que está dentro da área de uma dica de análise existente, o IInkAnalyzer também adicionará a caixa delimitadora do traço à região sujo do objeto IInkAnalyzer. Para obter mais informações sobre dicas de análise, consulte Propriedades da dica de análise.

Esse método pode gerar os eventos _IAnalysisProxyEvents::ContextNodeCreated, _IAnalysisProxyEvents::ContextNodeLinkAdding e _IAnalysisProxyEvents::ContextNodePropertiesUpdated enquanto carrega os resultados salvos.

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

Método IInkAnalyzer::GetDirtyRegion

Método IInkAnalyzer::SetDirtyRegion

Método IInkAnalyzer::SaveResults

Método IInkAnalyzer::SaveResultsForNodes

Método IInkAnalyzer::SaveResultsForStrokes

Referência de análise de tinta