Méthode IInkAnalyzer::AddStrokeForLanguage

Article
06/13/2023

Ajoute des données de trait pour un trait unique à IInkAnalyzer et affecte un identificateur de culture spécifique au trait.

Syntaxe

HRESULT AddStrokeForLanguage(
  [in]  LONG         lStrokeId,
  [in]  LONG         lStrokeLCID,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Paramètres

lStrokeId [in]: Identificateur du trait à ajouter.
lStrokeLCID [in]: Identificateur de culture à affecter au trait.
ulStrokePacketDataCount [in]: Nombre de paquets dans le trait.
plStrokePacketData [in]: Tableau contenant les données de paquet pour le trait.
ulStrokePacketDescriptionCount [in]: Nombre de propriétés dans chaque paquet.
pStrokePacketDescriptionGuids [in]: Tableau contenant les identificateurs de propriété de paquet.
ppContextNodeStrokeAddedTo [out]: Pointeur dont la valeur est définie sur le pointeur du IContextNode qui contient le trait nouvellement ajouté.

Valeur retournée

Pour obtenir une description des valeurs renvoyées, consultez Classes et interfaces - Analyse de l’entrée manuscrite.

Notes

Attention

Pour éviter une fuite de mémoire, appelez IUnknown::Release sur ppContextNodeStrokeAddedTo lorsque vous n’avez plus besoin d’utiliser l’objet .

Lorsque ppContextNodeStrokeAddedTo a la valeur NULL, cela indique que l’appelant n’est pas intéressé par la valeur de retour de la méthode .

IInkAnalyzer ajoute le trait à un IContextNode de type UnclassifiedInk (voir Types de nœuds de contexte). Ce nœud se trouve dans la collection de sous-nœuds du nœud racine (voir Méthodes IInkAnalyzer::GetRootNode et IContextNode::GetSubNodes ).

IInkAnalyzer affecte l’identificateur de culture lStrokeLCID au trait et ajoute le trait 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 le trait au nouveau nœud de contexte UnclassifiedInk.

plStrokePacketData contient des données de paquets pour tous les points du trait. pStrokePacketDescriptionGuids contient les identificateurs globaux uniques (GUID) qui décrivent les types de données de paquets inclus pour chaque point du trait. Pour obtenir la liste complète des propriétés de paquets disponibles, consultez Constantes PacketPropertyGuids.

Cette méthode étend le sale région à l’union de la valeur actuelle de la région et du cadre englobant du trait ajouté.

Si IInkAnalyzer contient déjà un trait avec le même identificateur de trait, IInkAnalyzer renvoie un HRESULTde E_INVALIDARG.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	IACom.h (nécessite également IACom_i.c)
DLL	IACom.dll

Voir aussi

IInkAnalyzer
IInkAnalyzer::AddStroke, méthode
IInkAnalyzer::AddStrokes, méthode
IInkAnalyzer::AddStrokesForLanguage, méthode
IInkAnalyzer::RemoveStroke, méthode
IInkAnalyzer::RemoveStrokes, méthode
Informations de référence sur l’analyse de l’encre