Método IInkAnalyzer::LoadResults
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 |
|
| DLL |
|