IInkAnalyzer::GetDirtyRegion-Methode

  • Artikel

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:

  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

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

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