IInkAnalyzer::CreateAnalysisHint-Methode

Fügt dem IInkAnalyzer einen neuen Analysehinweisknoten mit einem unendlichen Bereich hinzu.

Syntax

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

Parameter

ppAnalysisHint [out]

Der neue Analysehinweisknoten.

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 ppAnalysisHint auf, wenn Sie das -Objekt nicht mehr verwenden müssen.

Um zusätzliche Kontextinformationen für den IInkAnalyzer bereitzustellen, können Sie dem Freihandanalysator Analysehinweise hinzufügen. Analysehinweise können die Erkennungsgenauigkeit verbessern. Beispielsweise können Sie Fakten- und Leitfadeninformationen für Felder in einer Formularanwendung hinzufügen.

Diese Methode erstellt einen neuen IContextNode mit dem Kontextknotentyp AnalysisHint (siehe IContextNode::GetType) und fügt den neuen Hinweis als Unterknoten des Stammknotens des IInkAnalyzer-Objekts hinzu (siehe IContextNode::GetSubNodes und IInkAnalyzer::GetRootNode-Methode).

Um dem Hinweis Kontextinformationen hinzuzufügen, verwenden Sie IContextNode::AddPropertyData , wobei der pPropertyDataId-Parameter auf eine der Analysis Hint-Eigenschaftenkonstanten festgelegt ist.

Wenn einem Hinweis ein unendlicher Bereich zugewiesen wird, der als globaler Hinweis bezeichnet wird, wendet der IInkAnalyzer den Kontext des Hinweises auf alle Freihandeingaben an, die sich nicht im Bereich eines anderen Hinweises befinden. An einen einzelnen IInkAnalyzer können mehrere Hinweise angefügt werden. Allerdings kann nur ein globaler Hinweis an ein einzelnes Freihandanalysetool angefügt werden, und es können sich keine nicht globalen Hinweise überschneiden. Weitere Informationen zu den Typen von Kontextinformationen, die ein Hinweis bereitstellen kann, finden Sie unter Eigenschaften von Analysehinweisen.

Das Hinzufügen eines Analysehinweiss markiert nicht den Bereich des Hinweises für die Reanalyse. Um den Bereich innerhalb des Hinweises für die Reanalyse zu markieren, verwenden Sie IInkAnalyzer::SetDirtyRegion-Methode, um die modifiziert Region auf die Union der aktuellen modifiziert Region und des Bereichs des Analysehinweiss festzulegen.

Wenn Sie Hinweise für eine Formularanwendung verwenden, sollte die Anwendung vermeiden, dass Textkontext mit Freihand in den Formularen gemischt wird. Dies bedeutet beispielsweise, dass Textfeldnamen nicht in der Analysestruktur erstellt werden sollten. Hinweise sollen die Freihandbereiche auf Seiten zuordnen. Jeder Textkontext beeinträchtigt diese Freihand-zu-Hinweis-Zuordnung. Beim Analysevorgang können Freihand und Textkontext im gleichen Schreibbereich zusammengeführt werden, was verhindern würde, dass die Freihand dem Hinweisbereich zugeordnet wird.

Weitere Informationen zur Freihandanalyse finden Sie unter Übersicht über die Freihandanalyse.

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

IContextNode::AddPropertyData

IInkAnalyzer::D eleteAnalysisHint-Methode

IInkAnalyzer::GetAnalysisHints-Methode

IInkAnalyzer::GetAnalysisHintsByName-Methode

Eigenschaften der Analysehinweise

Freihandanalysereferenz