IInkAnalyzer::AddStrokeToCustomRecognizer-Methode

Fügt einem benutzerdefinierten Erkennungsknoten Strichdaten für einen einzelnen Strich hinzu.

Syntax

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parameter

ulStrokeId [in]

Der Bezeichner für den hinzuzufügenden Strich.

ulStrokePacketDataCount [in]

Die Anzahl der Pakete im Strich.

plStrokePacketData [in]

Ein Array, das die Paketdaten für den Strich enthält.

ulStrokePacketDescriptionCount [in]

Die Anzahl der Paketeigenschaften in jedem Paket.

pStrokePacketDescriptionGuids [in]

Ein Array, das die Paketeigenschaftenbezeichner enthält.

pCustomRecognizer [in]

Der IContextNode vom Typ CustomRecognizer , dem der Strich hinzugefügt werden soll.

ppContextNodeStrokeAddedTo [out]

Der IContextNode , dem das Freihandanalysetool den Strich hinzugefügt 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 ppContextNodeStrokeAddedTo auf, wenn Sie das -Objekt nicht mehr verwenden müssen.

Wenn ppContextNodeStrokeAddedToNULL ist, gibt dies an, dass der Aufrufer nicht am Rückgabewert der -Methode interessiert ist.

Der IInkAnalyzer fügt den Strich einem IContextNode des Typs CustomRecognizer hinzu (siehe Kontextknotentypen). Dieser Knoten befindet sich in der Unterknotenauflistung des Stammknotens (siehe IInkAnalyzer::GetRootNode-Methode und IContextNode::GetSubNodes-Methoden ).

Der IInkAnalyzer weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu und fügt den Strich dem ersten UnclassifiedInk-Knoten unter dem Knoten CustomRecognizer hinzu. Wenn kein UnclassifiedInk-Knoten vorhanden ist, wird er erstellt. Wenn der dem CustomRecognizer-Knotenzugeordnete IInkAnalysisRecognizer den Kulturbezeichner nicht unterstützt, setzt IInkAnalyzer die Analyse fort und generiert eine IAnalysisWarning-Warnung. Diese Warnung hat den AnalysisWarningCode-WertAnalysisWarningCode_LanguageIdNotRespected.

plStrokePacketData enthält Paketdaten für alle Punkte im Strich. pStrokePacketDescriptionGuids enthält die GUIDs (Globally Unique Identifiers), die die Typen von Paketdaten beschreiben, die für jeden Punkt in jedem Strich enthalten sind. Eine vollständige Liste der verfügbaren Paketeigenschaften finden Sie unter PacketPropertyGuids-Konstanten.

Diese Methode erweitert den modifiziert Bereichs auf die Vereinigung des aktuellen Werts des Bereichs und des Begrenzungsrahmens des hinzugefügten Strichs.

Der IInkAnalyzer gibt unter den folgenden Umständen ein HRESULT von E_INVALIDARG zurück.

• Der IInkAnalyzer enthält bereits einen Strich mit demselben Bezeichner wie der hinzuzufügende Strich.
• Der Parameter pCustomRecognizer enthält einen benutzerdefinierten Erkennungsknoten, der einem anderen IInkAnalyzer-Objekt zugeordnet ist.
• Der Parameter pCustomRecognizer enthält einen IContextNode , der nicht vom Typ CustomRecognizer ist.

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

Kontextknotentypen

IInkAnalyzer::AddStrokesToCustomRecognizer-Methode

IInkAnalyzer::CreateCustomRecognizer-Methode

Freihandanalysereferenz