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 effectue actuellement une analyse en arrière-plan.
• la région sale (voir Méthode IInkAnalyzer::GetDirtyRegion) représente une zone vide.

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.

• Votre application a défini la valeur AnalysisModesAnalysisModes_IntermediateResults dans IInkAnalyzer (voir IInkAnalyzer::SetAnalysisModes, méthode) et ne gère pas l’événement _IAnalysisEvents::IntermediateResults .
• Votre application a effacé la valeur AnalysisModesAnalysisModes_AutomaticReconciliation dans IInkAnalyzer (voir Méthode IInkAnalyzer::SetAnalysisModes) et ne gère pas l’événement _IAnalysisEvents::ReadyToReconcile .
• Votre application ne gère pas l’événement _IAnalysisEvents::Results .
• Votre application ne gère pas l’événement _IAnalysisEvents::UpdateStrokesCache .

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