Método IInkAnalyzer::BackgroundAnalyze

Executa 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 analisa a tinta dentro de sua região suja 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 suja 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 suja 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 seguintes circunstâncias.

Exemplos

O exemplo a seguir verifica a região suja do analisador de tinta e inicia a análise de tinta em segundo plano se a região suja 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