Méthode IInkAnalyzer::AddStrokesForLanguage

  • Article

Ajoute des données de trait pour plusieurs traits à IInkAnalyzer et affecte 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 [in]

Nombre de traits à ajouter.

plIdofStrokesToAdd [in]

Tableau contenant les identificateurs de trait.

lStrokesLCID [in]

Valeur qui représente l’identificateur de culture à affecter aux traits.

ulStrokePacketDescriptionCount [in]

Nombre de propriétés dans chaque paquet.

pStrokePacketDescriptionGuids [in]

Tableau contenant les identificateurs de propriété de paquet.

pulPacketDataCountPerStroke [in]

Tableau contenant le nombre de paquets dans chaque trait.

plStrokePacketData [in]

Tableau contenant les données de paquets pour les traits.

ppContextNodeStrokeAddedTo [out]

IContextNode auquel l’analyseur d’encre a ajouté les traits.

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 les traits à 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 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 paquets 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 paquets disponibles, consultez Constantes PacketPropertyGuids.

Notes

Seuls les traits avec les mêmes descriptions de paquets peuvent être ajoutés en un seul appel à la méthode IInkAnalyzer::AddStrokes.

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

Si IInkAnalyzer contient déjà un trait avec le même identificateur que l’un des traits à ajouter, 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::AddStrokeForLanguage, méthode

IInkAnalyzer::AddStrokes, méthode

IInkAnalyzer::RemoveStroke, méthode

IInkAnalyzer::RemoveStrokes, méthode

Informations de référence sur l’analyse de l’encre