IInkAnalyzer::BackgroundAnalyze-Methode

Führt eine asynchrone Freihandanalyse durch.

Syntax

HRESULT BackgroundAnalyze();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

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

Hinweise

Wenn diese Methode aufgerufen wird, führt der IInkAnalyzer die Freihandanalyse auf einem Hintergrundthread aus.

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

Der IInkAnalyzer analysiert Freihand in seinem schmutzigen Bereich während eines Aufrufs von IInkAnalyzer::Analysemethode oder IInkAnalyzer::BackgroundAnalyze-Methode. Der IInkAnalyzer kann jedoch den Analysevorgang erweitern, um benachbarte Regionen einzuschließen.

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

Wenn Strichdaten dem IInkAnalyzer nach dem Aufruf von IInkAnalyzer::BackgroundAnalyze-Methode hinzugefügt wurden, kann der IInkAnalyzer die schmutzige Region während der Abgleichsphase der Freihandanalyse aktualisieren.

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

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

Beispiele

Im folgenden Beispiel wird der schmutzige Bereich des Freihandanalyses überprüft und dann die Hintergrund-Freihandanalyse initiiert, wenn der schmutzige 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

Siehe auch

IInkAnalyzer

Analysismodes

IInkAnalyzer::Analysemethode

IInkAnalyzer::GetAnalysisModes-Methode

IInkAnalyzer::SetAnalysisModes-Methode

IInkAnalyzer::GetDirtyRegion-Methode

IInkAnalyzer::SetDirtyRegion-Methode

IInkAnalyzer::GetRootNode-Methode

Freihandanalysereferenz