IInkAnalyzer::AddStrokes-Methode
Fügt dem IInkAnalyzer Strichdaten für mehrere Striche hinzu und weist den Strichen den Kulturbezeichner des aktiven Eingabethreads zu.
Syntax
HRESULT AddStrokes(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plStrokeIds,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[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.
-
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 UnclassifiedInk 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-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 die Striche dem neuen UnclassifiedInk-Kontextknoten hinzu.
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::AddStrokes-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.
Wenn der IInkAnalyzer bereits einen Strich mit demselben Bezeichner wie einer der hinzuzufügenden Striche 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 |
|