IInkAnalyzer::GetDirtyRegion-Methode

Ruft den Bereich ab, der sich seit dem letzten Analysevorgang geändert hat.

Syntax

HRESULT GetDirtyRegion(
  [out] IAnalysisRegion **ppDirtyRegion
);

Parameter

ppDirtyRegion [out]

Eine IAnalysisRegion , die den Bereich beschreibt, der sich seit dem letzten Analysevorgang geändert hat.

Rückgabewert

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

Bemerkungen

Diese Methode identifiziert die Bereiche, die analysiert oder neu analysiert werden müssen. Alle IInkAnalyzer-Methoden, die Strichdaten hinzufügen, aktualisieren oder entfernen, aktualisieren oder entfernen, aktualisieren die modifiziert Region. So markieren Sie einen Bereich für die Reanalyse manuell:

1. Rufen Sie die modifiziert Region mithilfe der IInkAnalyzer::GetDirtyRegion-Methode ab.
2. Verwenden Sie IAnalysisRegion::UnionRegion-Methode oder IAnalysisRegion::UnionRectangle-Methode , um den Bereich der Region aus Schritt 1 hinzuzufügen.
3. Verwenden Sie IInkAnalyzer::SetDirtyRegion-Methode, um die modifiziert Region zu aktualisieren.

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

Diese Eigenschaft kann nicht zusammenhängende Bereiche enthalten.

Verwenden Sie CoTaskMemFree , um den Arbeitsspeicher aus dem ppDirtyRegion-Array freizugeben, wenn Sie damit fertig sind.

Anforderungen

Siehe auch

IInkAnalyzer

IInkAnalyzer::Analyze-Methode

IInkAnalyzer::BackgroundAnalyze-Methode

IInkAnalyzer::AddStroke-Methode

IInkAnalyzer::AddStrokeForLanguage-Methode

IInkAnalyzer::AddStrokes-Methode

IInkAnalyzer::AddStrokesForLanguage-Methode

IInkAnalyzer::RemoveStroke-Methode

IInkAnalyzer::RemoveStrokes-Methode

IInkAnalyzer::UpdateStrokesData-Methode

Freihandanalysereferenz