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 Paketeigenschaftenbezeichner 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 – 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 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 den Kulturbezeichner des aktiven Eingabethreads zu und fügt den Strich dem ersten UnclassifiedInk-Kontextknoten unter dem Stammknoten der Freihandanalyse 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 UnclassifiedInk-Kontextknoten hinzu.
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 des Strichs 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.
Wenn der IInkAnalyzer bereits einen 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 |
|
| DLL |
|