Partager via


Méthode IInkAnalyzer::BackgroundAnalyze

Effectue une analyse asynchrone de l’entrée manuscrite.

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.

Notes

Lorsque cette méthode est appelée, IInkAnalyzer effectue l’analyse de l’entrée 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’entrée manuscrite dans sa région sale lors d’un appel à la méthode IInkAnalyzer::Analyze ou à la méthode IInkAnalyzer::BackgroundAnalyze. Toutefois, IInkAnalyzer peut étendre l’opération d’analyse pour inclure les 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 à la méthode IInkAnalyzer::BackgroundAnalyze, 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 Méthode IInkAnalyzer::GetAnalysisModes) spécifie la façon dont IInkAnalyzer effectue l’analyse en arrière-plan. Pour plus d’informations sur l’analyse manuscrite, consultez Vue d’ensemble de l’analyse d’encre.

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 de l’encre 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 Édition Tablet PC [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::Analyze, 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