Método IInkAnalyzer::Analyze

Executa a análise de tinta síncrona.

Sintaxe

HRESULT Analyze(
  [out] IAnalysisStatus **ppStatus
);

Parâmetros

ppStatus [out]

Um ponteiro para um IAnalysisStatus que descreve o status da operação de análise.

Valor retornado

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

Comentários

Cuidado

Para evitar uma perda de memória, chame IUnknown::Release em ppStatus quando você não precisar mais usar a análise status.

Esse método inicia uma operação de análise de tinta síncrona. A análise de tinta inclui análise de layout, classificação de desenho e escrita e reconhecimento de manuscrito. Esse método retorna após a conclusão da operação de análise.

Esse método retornará E_POINTER se ppStatus for NULL.

Durante uma chamada ao Método IInkAnalyzer::Analyze ou ao Método IInkAnalyzer::BackgroundAnalyze, o IInkAnalyzer analisa a tinta em sua região de sujo (consulte Método IInkAnalyzer::GetDirtyRegion). No entanto, o IInkAnalyzer pode expandir a operação de análise para incluir regiões vizinhas.

Esse método define a região sujo do objeto IInkAnalyzer como uma região vazia. Se outro thread tiver adicionado dados de traço que não foram analisados, o IInkAnalyzer adicionará a caixa delimitadora dos traços não analisados à sua região sujo durante a fase de reconciliação da análise.

Esse método retornará um erro se o aplicativo não manipular o evento _IAnalysisEvents::UpdateStrokesCache .

O IInkAnalyzer não gera os eventos _IAnalysisEvents::Results e _IAnalysisEvents::IntermediateResults em resposta a esse método.

Para modificar a maneira como a análise de tinta é executada, use o Método IInkAnalyzer::SetAnalysisModes.

Para obter mais informações sobre a análise de tinta, consulte Visão geral da análise de tinta.

Exemplos

O exemplo a seguir executa a análise de tinta em primeiro plano.

// Perform synchronous ink analysis.
IAnalysisStatus *pAnalysisStatus = NULL;
hr = this->m_spIInkAnalyzer->Analyze(&pAnalysisStatus);

if (SUCCEEDED(hr))
{
    // Insert code that processes the analysis results.
}

// Release this reference to the analysis status.
if (pAnalysisStatus != NULL)
{
    pAnalysisStatus->Release();
    pAnalysisStatus = NULL;
}

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

AnalysisModes

Método IInkAnalyzer::GetDirtyRegion

Método IInkAnalyzer::SetDirtyRegion

Método IInkAnalyzer::GetRootNode

Método IInkAnalyzer::BackgroundAnalyze