IInkAnalyzer::AddStrokeForLanguage-Methode

Fügt dem IInkAnalyzer Strichdaten für einen einzelnen Strich hinzu und weist der Strich einen bestimmten Kulturbezeichner zu.

Syntax

HRESULT AddStrokeForLanguage(
  [in]  LONG         lStrokeId,
  [in]  LONG         lStrokeLCID,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parameter

lStrokeId [in]

Der Bezeichner für den hinzuzufügenden Strich.

lStrokeLCID [in]

Der Kulturbezeichner, der dem Strich zugewiesen werden soll.

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 Eigenschaften in jedem Paket.

pStrokePacketDescriptionGuids [in]

Ein Array, das die Paketeigenschaftenbezeichner enthält.

ppContextNodeStrokeAddedTo [out]

Ein Zeiger, dessen Wert auf den Zeiger des IContextNode festgelegt ist, der den neu hinzugefügten Strich enthält.

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 Strich einem IContextNode vom Typ UnclassifiedInk 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 lStrokeLCID-Kulturbezeichner zu und fügt den Strich dem ersten UnclassifiedInk-Kontextknoten unter dem Stammknoten des Freihandanalysetools hinzu, der Striche mit demselben Kulturbezeichner enthält. Wenn die Freihandanalyse nicht über einen Knoten mit demselben Kulturbezeichner verfügt, erstellt sie einen neuen UnclassifiedInk-Kontextknoten unter dem Stammknoten und fügt den Strich dem neuen Kontextknoten UnclassifiedInk hinzu.

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

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

Wenn der IInkAnalyzer bereits eine Strich mit demselben Strichbezeichner enthält, gibt der IInkAnalyzer ein HRESULT von E_INVALIDARG zurück.

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

IInkAnalyzer::AddStroke-Methode

IInkAnalyzer::AddStrokes-Methode

IInkAnalyzer::AddStrokesForLanguage-Methode

IInkAnalyzer::RemoveStroke-Methode

IInkAnalyzer::RemoveStrokes-Methode

Freihandanalysereferenz