Método IInkAnalyzer::Abort

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

Sintaxe

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

Parâmetros

ppAbortedRegion [out]

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

Valor retornado

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

Comentários

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

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

Quando ppAbortedRegion é NULL, esse método executa a anulação normalmente, pois isso indica que o chamador não tem interesse no valor retornado.

O Método IInkAnalyzer::Abort 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 de análise em segundo plano atual 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 sujo da operação e as chamadas subsequentes retornarão uma região vazia.

Se seu aplicativo mantiver sua própria estrutura de dados sincronizada com a do IInkAnalyzer, chamar o Método IInkAnalyzer::Abort poderá deixar seu documento com resultados parciais. Para evitar isso, não chame o Método IInkAnalyzer::Abort entre a hora em que iInkAnalyzer recebe o evento _IAnalysisProxyEvents::InkAnalyzerStateChanging e a hora 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.

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

Método IInkAnalyzer::Analyze

Método IInkAnalyzer::BackgroundAnalyze

Método IInkAnalyzer::GetDirtyRegion

Método IInkAnalyzer::SetDirtyRegion

Referência de análise de tinta