IInkAnalyzer::AddStrokesToCustomRecognizer-Methode

Fügt einem benutzerdefinierten Erkennungsknoten Strichdaten für mehrere Striche hinzu.

Syntax

HRESULT AddStrokesToCustomRecognizer(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plStrokeIds,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  ULONG        *pulPacketDataCountPerStroke,
  [in]  LONG         *plStrokePacketData,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parameter

ulStrokeIdsCount [in]

Die Anzahl der hinzuzufügenden Striche.

plStrokeIds [in]

Ein Array, das die Strichbezeichner enthält.

ulStrokePacketDescriptionCount [in]

Die Anzahl der Eigenschaften in jedem Paket.

pStrokePacketDescriptionGuids [in]

Ein Array, das die Paketeigenschaftenbezeichner enthält.

pulPacketDataCountPerStroke [in]

Ein Array, das die Anzahl der Pakete in jedem Strich enthält.

plStrokePacketData [in]

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

pCustomRecognizer [in]

Der IContextNode vom Typ CustomRecognizer , dem die Striche hinzugefügt werden sollen.

ppContextNodeStrokeAddedTo [out]

Der IContextNode , dem die Freihandanalyse die Striche 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 an dem Rückgabewert der -Methode interessiert ist.

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

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

plStrokePacketData enthält Paketdaten für alle Striche. pStrokePacketDescriptionGuids enthält die GLOBALLY UNIQUE Identifiers (GUIDs), 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.

Hinweis

Nur Striche mit denselben Paketbeschreibungen können in einem einzelnen Aufruf der IInkAnalyzer::AddStrokesToCustomRecognizer-Methode hinzugefügt werden.

Diese Methode erweitert die modifiziert Region auf die Union des aktuellen Werts der Region und das Begrenzungsfeld der hinzugefügten Striche.

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 einer der hinzuzufügenden Striche.
• Der pCustomRecognizer-Parameter enthält einen benutzerdefinierten Erkennungsknoten, der einem anderen IInkAnalyzer-Objekt zugeordnet ist.
• Der pCustomRecognizer-Parameter 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

Weitere Informationen

IInkAnalyzer

Kontextknotentypen

IInkAnalyzer::AddStrokeToCustomRecognizer-Methode

IInkAnalyzer::CreateCustomRecognizer-Methode

Freihandanalysereferenz