IInkAnalyzer::BackgroundAnalyze, méthode

Effectue une analyse manuscrite asynchrone.

Syntaxe

HRESULT BackgroundAnalyze();

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse manuscrite.

Remarques

Lorsque cette méthode est appelée, IInkAnalyzer effectue l’analyse manuscrite sur un thread d’arrière-plan.

Cette méthode retourne S_FALSE et ne démarre pas une nouvelle opération d’analyse en arrière-plan dans les circonstances suivantes.

IInkAnalyzer analyse l’encre dans sa région sale pendant un appel à IInkAnalyzer::Analysis, méthode ou IInkAnalyzer::BackgroundAnalyze, méthode. Toutefois, IInkAnalyzer peut développer l’opération d’analyse pour inclure des régions voisines.

Cette méthode définit la région sale sur une région vide.

Si des données de trait ont été ajoutées à IInkAnalyzer après l’appel à IInkAnalyzer::BackgroundAnalyze, la méthode IInkAnalyzer peut mettre à jour la région sale pendant la phase de rapprochement de l’analyse manuscrite.

Le paramètre des modes d’analyse (voir IInkAnalyzer::GetAnalysisModes, méthode) spécifie comment IInkAnalyzer effectue une analyse en arrière-plan. Pour plus d’informations sur l’analyse manuscrite, consultez Vue d’ensemble de l’analyse manuscrite.

Cette méthode retourne un code d’erreur dans les circonstances suivantes.

Exemples

L’exemple suivant vérifie la région sale de l’analyseur d’encre, puis lance l’analyse manuscrite en arrière-plan si la région sale n’est pas vide.

// 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();
}

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
IACom.h (nécessite également IACom_i.c)
DLL
IACom.dll

Voir aussi

IInkAnalyzer

AnalysisModes

IInkAnalyzer::Analysis, méthode

IInkAnalyzer::GetAnalysisModes, méthode

IInkAnalyzer::SetAnalysisModes, méthode

IInkAnalyzer::GetDirtyRegion, méthode

IInkAnalyzer::SetDirtyRegion, méthode

IInkAnalyzer::GetRootNode, méthode

Informations de référence sur l’analyse manuscrite