Auf Englisch lesen

Freigeben über


IInkAnalyzer::BackgroundAnalyze-Methode

Führt eine asynchrone Freihandanalyse aus.

Syntax

HRESULT BackgroundAnalyze();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Bemerkungen

Wenn diese Methode aufgerufen wird, führt IInkAnalyzer die Freihandanalyse für einen Hintergrundthread aus.

Diese Methode gibt S_FALSE zurück und startet unter den folgenden Umständen keinen neuen Hintergrundanalysevorgang.

Der IInkAnalyzer analysiert freihand in seinem modifiziert Bereich während eines Aufrufs der IInkAnalyzer::Analyze-Methode oder der IInkAnalyzer::BackgroundAnalyze-Methode. Der IInkAnalyzer kann den Analysevorgang jedoch auf benachbarte Regionen erweitern.

Diese Methode legt den modifiziert Bereich auf einen leeren Bereich fest.

Wenn dem IInkAnalyzer nach dem Aufruf der IInkAnalyzer::BackgroundAnalyze-Methode Strichdaten hinzugefügt wurden, kann der IInkAnalyzer den modifiziert Bereich während der Abstimmungsphase der Freihandanalyse aktualisieren.

Die Einstellung für Analysemodi (siehe IInkAnalyzer::GetAnalysisModes-Methode) gibt an, wie die IInkAnalyzer-Hintergrundanalyse ausführt. Weitere Informationen zur Freihandanalyse finden Sie unter Übersicht über die Freihandanalyse.

Diese Methode gibt unter den folgenden Umständen einen Fehlercode zurück.

Beispiele

Im folgenden Beispiel wird der modifiziert Bereich des Freihandanalysetools überprüft, und dann wird die Freihandanalyse im Hintergrund initiiert, wenn der modifiziert Bereich nicht leer ist.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
IACom.h (erfordert auch IACom_i.c)
DLL
IACom.dll

Weitere Informationen

IInkAnalyzer

Analysismodes

IInkAnalyzer::Analyze-Methode

IInkAnalyzer::GetAnalysisModes-Methode

IInkAnalyzer::SetAnalysisModes-Methode

IInkAnalyzer::GetDirtyRegion-Methode

IInkAnalyzer::SetDirtyRegion-Methode

IInkAnalyzer::GetRootNode-Methode

Freihandanalysereferenz