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
Achtung
Um einen Speicherverlust zu vermeiden, rufen Sie IUnknown::Release auf ppDirtyRegion auf, wenn Sie das Objekt nicht mehr verwenden müssen.
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:
- Rufen Sie die modifiziert Region mithilfe der IInkAnalyzer::GetDirtyRegion-Methode ab.
- Verwenden Sie IAnalysisRegion::UnionRegion-Methode oder IAnalysisRegion::UnionRectangle-Methode , um den Bereich der Region aus Schritt 1 hinzuzufügen.
- 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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|