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 führt derzeit eine Hintergrundanalyse durch.
• die modifiziert Region (siehe IInkAnalyzer::GetDirtyRegion-Methode) stellt einen leeren Bereich dar.

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.

• Ihre Anwendung hat den AnalysisModes-WertAnalysisModes_IntermediateResults im IInkAnalyzer festgelegt (siehe IInkAnalyzer::SetAnalysisModes-Methode) und behandelt das ereignis _IAnalysisEvents::IntermediateResults nicht.
• Ihre Anwendung hat den AnalysisModes-WertAnalysisModes_AutomaticReconciliation im IInkAnalyzer gelöscht (siehe IInkAnalyzer::SetAnalysisModes-Methode) und behandelt das ereignis _IAnalysisEvents::ReadyToReconcile nicht.
• Ihre Anwendung behandelt das ereignis _IAnalysisEvents::Results nicht.
• Ihre Anwendung behandelt das ereignis _IAnalysisEvents::UpdateStrokesCache nicht.

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