IInkAnalyzer::AddStroke-Methode

Fügt dem IInkAnalyzer Strichdaten für einen einzelnen Strich hinzu und weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu.

Syntax

HRESULT AddStroke(
  [in]  LONG         lStrokeId,
  [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.

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 Paketeigenschaftsbezeichner enthält.

ppContextNodeStrokeAddedTo [ out]

Ein Zeiger auf den IContextNode, dem der IInkAnalyzer den Strich hinzugefügt hat.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Ink-Analyse.

Hinweise

Achtung

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

Wenn ppContextNodeStrokeAddedTo NULL ist, gibt dies an, dass der Aufrufer nicht an dem Rückgabewert der Methode interessiert ist.

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

IInkAnalyzer weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu und fügt den Strich dem ersten UnclassifiedInk-Kontextknoten unter dem Stammknoten des Freihandanalysetools hinzu, der Striche mit dem gleichen Kulturbezeichner enthält. Wenn das Freihandanalyseprogramm keinen Knoten mit demselben Kulturbezeichner hat, erstellt er einen neuen UnclassifiedInk-Kontextknoten unter seinem Stammknoten und fügt den Strich dem neuen UnclassifiedInk-Kontextknoten hinzu.

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

Diese Methode erweitert den geänderten Bereich auf die Vereinigung des aktuellen Werts des Bereichs und des begrenzungsfelds des hinzugefügten Strichs.

Wenn der IInkAnalyzer bereits einen Strich mit dem gleichen Strichbezeichner enthält, gibt der IInkAnalyzer ein HRESULT von E _ INVALIDARG zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
IACom.h (erfordert auch IACom _ i.c)
DLL
IACom.dll

Siehe auch

Inkanalyzer

IInkAnalyzer::AddStrokeForLanguage-Methode

IInkAnalyzer::AddStrokes-Methode

IInkAnalyzer::AddStrokesForLanguage-Methode

IInkAnalyzer::RemoveStroke-Methode

IInkAnalyzer::RemoveStrokes-Methode

Referenz zur Ink-Analyse