IInkAnalyzer::Reconcile-Methode
Wendet die Ergebnisse eines Freihandanalysevorgangs im Hintergrund auf die Kontextknotenstruktur für die Teile der Struktur an, die seit dem Aufruf der IInkAnalyzer::BackgroundAnalyze-Methode von der Anwendung nicht geändert wurden.
Syntax
HRESULT Reconcile();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.
Bemerkungen
Standardmäßig führt der IInkAnalyzer unmittelbar vor dem Auslösen der Ereignisse _IAnalysisEvents::IntermediateResults und _IAnalysisEvents::Results eine automatische Abstimmungsphase aus.
Um die automatische Abstimmung zu deaktivieren, löschen Sie das flag AnalysisModes_AutomaticReconciliation aus den Analysemodi der Freihandanalyse (siehe IInkAnalyzer::SetAnalysisModes-Methode und AnalysisModes). Die IInkAnalyzer::BackgroundAnalyze-Methode gibt einen Fehler zurück, wenn die automatische Abstimmung deaktiviert ist und Ihre Anwendung das ereignis _IAnalysisEvents::ReadyToReconcile nicht verarbeitet. Ihre Anwendung muss die IInkAnalyzer::Reconcile-Methode aufrufen, bevor IInkAnalyzer die Ergebnisse weiter verarbeiten oder die weitere Analyse für die entsprechende Analysephase fortsetzen kann.
Ihre Anwendung kann während der Hintergrundanalyse Änderungen in der Kontextknotenstruktur des IInkAnalyzer-Objekts vornehmen, z. B. das Hinzufügen oder Entfernen von Strichen und das Ändern von Strichdaten. Solche Änderungen können Teile der Ergebnisse der Hintergrundanalyse ungültig werden. Diese Methode wendet Analyseergebnisse nur auf die Kontextknotenstruktur des Analysetools für die Teile der Struktur an, die Ihre Anwendung nicht geändert hat. Diese Methode fügt auch Regionen mit ungültigen Analyseergebnissen zum modifiziert Bereich des IInkAnalyzer-Objekts hinzu (siehe IInkAnalyzer::GetDirtyRegion-Methode).
Weitere Informationen zur Verwendung von zum Analysieren von Freihandeingaben finden Sie unter Übersicht über die Freihandanalyse. Analysismodes
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Nicht unterstützt |
Header |
|
DLL |
|