Método IInkAnalyzer::Abort

Cancela a operação de análise atual.

Sintaxe

HRESULT Abort(
  [out] IAnalysisRegion **ppAbortedRegion
);

Parâmetros

ppAbortedRegion [saída]

Um ponteiro para um IAnalysisRegion que representa a região suja (consulte IInkAnalyzer::GetDirtyRegion Method) da operação de análise atual.

Valor de retorno

Para obter uma descrição dos valores de retorno, consulte Classes e interfaces - Análise de tinta.

Observações

Chame IUnknown::Release em ppAbortedRegion quando não precisar mais usar o objeto.

Este método cancela a operação de análise atual.

Quando ppAbortedRegion é NULL, esse método executa o abort normalmente, porque isso indica que o chamador não tem interesse no valor de retorno.

IInkAnalyzer::Abort Method silencia os eventos _IAnalysisEvents::Results e _IAnalysisEvents::Activity para a operação de análise atual.

O método IInkAnalyzer::Abort é executado de forma assíncrona até que a operação atual de análise em segundo plano seja cancelada. Como o processo de cancelamento é assíncrono, o aplicativo pode executar outras tarefas enquanto as operações de análise atuais são canceladas.

Se nenhuma operação de análise estiver em andamento, esse método retornará uma região de análise vazia.

Se uma operação de análise estiver em andamento, esse método cancelará a operação.

Se as operações de análise síncrona e assíncrona estiverem em andamento, esse método cancelará a operação síncrona.

Se esse método for chamado mais de uma vez para a mesma operação de análise, a primeira chamada retornará a região suja da operação e as chamadas subsequentes retornarão uma região vazia.

Se seu aplicativo mantém sua própria estrutura de dados sincronizada com a do IInkAnalyzer, chamar o Método IInkAnalyzer::Abort pode deixar seu documento com resultados parciais. Para evitar isso, não chame o método IInkAnalyzer::Abort entre o momento em que o IInkAnalyzer recebe o evento _IAnalysisProxyEvents::InkAnalyzerStateChanging e o momento em que o IInkAnalyzer recebe o evento _IAnalysisEvents::IntermediateResults ou _IAnalysisEvents::Results .

Para obter mais informações sobre como sincronizar os dados do aplicativo com o analisador de tinta, consulte Proxy de dados com análise de tinta.

Requerimentos

Ver também

IInkAnalyzer

Método IInkAnalyzer::Analyze

Método IInkAnalyzer::BackgroundAnalyze

Método IInkAnalyzer::GetDirtyRegion

Método IInkAnalyzer::SetDirtyRegion

Referência da Análise de Tinta