Método IInkAnalyzer::BackgroundAnalyze

Executa a análise de tinta assíncrona.

Sintaxe

HRESULT BackgroundAnalyze();

Parâmetros

Esse método não tem parâmetros.

Valor retornado

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

Comentários

Quando esse método é chamado, o IInkAnalyzer executa a análise de tinta em um thread em segundo plano.

Esse método retorna S_FALSE e não inicia uma nova operação de análise em segundo plano nas circunstâncias a seguir.

• O IInkAnalyzer está executando a análise em segundo plano no momento.
• a região sujo (consulte Método IInkAnalyzer::GetDirtyRegion) representa uma área vazia.

O IInkAnalyzer analisa a tinta em sua região de sujo durante uma chamada para o Método IInkAnalyzer::Analyze ou método IInkAnalyzer::BackgroundAnalyze. 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 como uma região vazia.

Se os dados de traço foram adicionados ao IInkAnalyzer após a chamada ao Método IInkAnalyzer::BackgroundAnalyze, o IInkAnalyzer poderá atualizar a região sujo durante a fase de reconciliação da análise de tinta.

A configuração de modos de análise (consulte Método IInkAnalyzer::GetAnalysisModes) especifica como o IInkAnalyzer executa a análise em segundo plano. Para obter mais informações sobre a análise de tinta, consulte Visão geral da análise de tinta.

Esse método retorna um código de erro nas circunstâncias a seguir.

• Seu aplicativo definiu o valor analysismodesAnalysisModes_IntermediateResults no IInkAnalyzer (consulte Método IInkAnalyzer::SetAnalysisModes) e não manipula o evento _IAnalysisEvents::IntermediateResults .
• Seu aplicativo limpou o valor analysismodesAnalysisModes_AutomaticReconciliation no IInkAnalyzer (consulte Método IInkAnalyzer::SetAnalysisModes) e não manipula o evento _IAnalysisEvents::ReadyToReconcile .
• Seu aplicativo não manipula o evento _IAnalysisEvents::Results .
• Seu aplicativo não manipula o evento _IAnalysisEvents::UpdateStrokesCache .

Exemplos

O exemplo a seguir verifica a região de sujo do analisador de tinta e inicia a análise de tinta em segundo plano se a sujo região não estiver vazia.

// Check that the ink analyzer's dirty region is not empty.
IAnalysisRegion *pDirtyRegion;
hr = this->m_spIInkAnalyzer->GetDirtyRegion(&pDirtyRegion);

if (SUCCEEDED(hr))
{
    VARIANT_BOOL bIsEmpty;
    hr = pDirtyRegion->IsEmpty(&bIsEmpty);

    if (SUCCEEDED(hr))
    {
        if (!bIsEmpty)
        {
            // Insert code that prepares the application for background
            // ink analysis here.

            // Start background ink analysis. The _IAnalysisEvents::Results
            // event signals when background ink analysis is complete.
            hr = this->m_spIInkAnalyzer->BackgroundAnalyze();
        }
    }
}

// Free the memory for the dirty region.
if (pDirtyRegion != NULL)
{
    pDirtyRegion->Release();
}

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::Analyze

Método IInkAnalyzer::GetAnalysisModes

Método IInkAnalyzer::SetAnalysisModes

Método IInkAnalyzer::GetDirtyRegion

Método IInkAnalyzer::SetDirtyRegion

Método IInkAnalyzer::GetRootNode

Referência de análise de tinta