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 |
|
| DLL |
|