IInkAnalyzer :: AddStrokesForLanguage, méthode
Ajoute des données de trait pour plusieurs traits à IInkAnalyzer et assigne l’identificateur de culture spécifié aux traits.
Syntaxe
HRESULT AddStrokesForLanguage(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plIdofStrokesToAdd,
[in] LONG lStrokesLCID,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Paramètres
-
ulStrokeIdsCount [ dans]
-
Nombre de traits à ajouter.
-
plIdofStrokesToAdd [ dans]
-
Tableau contenant les identificateurs de trait.
-
lStrokesLCID [ dans]
-
Valeur qui représente l’identificateur de culture à assigner aux traits.
-
ulStrokePacketDescriptionCount [ dans]
-
Nombre de propriétés dans chaque paquet.
-
pStrokePacketDescriptionGuids [ dans]
-
Tableau contenant les identificateurs de propriété de paquet.
-
pulPacketDataCountPerStroke [ dans]
-
Tableau contenant le nombre de paquets dans chaque trait.
-
plStrokePacketData [ dans]
-
Tableau contenant les données du paquet pour les traits.
-
ppContextNodeStrokeAddedTo [ à]
-
IContextNode auquel l’analyseur d’encre a ajouté les traits.
Valeur retournée
Pour obtenir une description des valeurs de retour, consultez classes et interfaces-analysede l’encre.
Remarques
Attention
Pour éviter une fuite de mémoire, appelez IUnknown :: Release sur ppContextNodeStrokeAddedTo lorsque vous n’avez plus besoin d’utiliser l’objet.
Quand ppContextNodeStrokeAddedTo a la valeur null, il indique que l’appelant ne s’intéresse pas à la valeur de retour de la méthode.
IInkAnalyzer ajoute les traits à un IContextNode de type UnclassifiedInk (consultez types de nœuds de contexte). Ce nœud se trouve dans la collection de sous-nœuds du nœud racine (consultez les méthodes IInkAnalyzer :: GetRootNode et IContextNode :: GetSubNodes ).
IInkAnalyzer assigne l’identificateur de culture lStrokeLCID aux traits et ajoute les traits au premier nœud de contexte UnclassifiedInk sous le nœud racine de l’analyseur d’encre qui contient des traits avec le même identificateur de culture. Si l’analyseur d’encre n’a pas de nœud avec le même identificateur de culture, il crée un nœud de contexte UnclassifiedInk sous son nœud racine et ajoute les traits au nouveau nœud de contexte UnclassifiedInk.
plStrokePacketData contient des données de paquet pour tous les traits. pStrokePacketDescriptionGuids contient les identificateurs globaux uniques (Guid) qui décrivent les types de données de paquets inclus pour chaque point de chaque trait. Pour obtenir la liste complète des propriétés de paquet disponibles, consultez constantes PacketPropertyGuids.
Notes
Seuls les traits avec les mêmes descriptions de paquets peuvent être ajoutés dans un seul appel à la méthode IInkAnalyzer :: AddStrokes.
Cette méthode étend la région modifiée à l’Union de la valeur actuelle de la zone et du cadre englobant des traits ajoutés.
Si le IInkAnalyzer contient déjà un trait avec le même identificateur que l’un des traits à ajouter, le IInkAnalyzer retourne un HRESULT d' E _ INVALIDARG.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Applications de bureau XP Édition Tablet PC [ uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
| DLL |
|