IInkAnalyzer::GetAnalysisHintsByName-Methode

Ruft alle Analysehinweise IContextNode-Objekte ab, die an den IInkAnalyzer angefügt sind und den angegebenen Namen haben.

Syntax

HRESULT GetAnalysisHintsByName(
  [in]  BSTR          hintName,
  [out] IContextNodes **ppAnalysisHints
);

hintName [in]: Der Name des Hinweises, nach dem gesucht werden soll.
ppAnalysisHints [out]: Der Analysehinweis IContextNode-Objekte im IInkAnalyzer , die den angegebenen Namen haben.

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

Achtung

Um einen Speicherverlust zu vermeiden, rufen Sie IUnknown::Release auf ppAnalysisHints auf, wenn Sie das Objekt nicht mehr verwenden müssen.

Diese Methode gibt eine leere Auflistung zurück, wenn keine solchen Analysehinweisknoten an den IInkAnalyzer angefügt sind.

Ein Analysehinweisknoten ist ein IContextNode mit dem Kontextknotentyp AnalysisHint (siehe IContextNode::GetType und Kontextknotentypen).

Um dem Hinweis Kontextinformationen hinzuzufügen, verwenden Sie IContextNode::AddPropertyData , wobei der pPropertyDataId-Parameter auf einen der globalen eindeutigen Bezeichner (GUIDs) in den Analysehinweiseigenschaften-Konstanten festgelegt ist.

Um zu ermitteln, welche Eigenschaftswerte auf einem Kontextknoten festgelegt sind, verwenden Sie IContextNode::GetPropertyDataIds. Um den Wert einer Eigenschaft zu ermitteln, verwenden Sie IContextNode::GetPropertyData.

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