IInkAnalyzer :: AddStrokesToCustomRecognizer, méthode

Ajoute des données de trait pour plusieurs traits à un nœud de reconnaissance personnalisé.

Syntaxe

HRESULT AddStrokesToCustomRecognizer(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plStrokeIds,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  ULONG        *pulPacketDataCountPerStroke,
  [in]  LONG         *plStrokePacketData,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Paramètres

ulStrokeIdsCount [ dans]

Nombre de traits à ajouter.

plStrokeIds [ dans]

Tableau contenant les identificateurs de trait.

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.

pCustomRecognizer [ dans]

IContextNode de type CustomRecognizer auquel ajouter 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 CustomRecognizer (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 du thread d’entrée actif aux traits et ajoute les traits au premier nœud UnclassifiedInk sous le nœud CustomRecognizer . Si aucun nœud UnclassifiedInk n’existe, il est créé. Si le IInkAnalysisRecognizer associé au nœud CustomRecognizer ne prend pas en charge l’identificateur de culture, le IInkAnalyzer continue à analyser et génère un avertissement IAnalysisWarning . Cet avertissement a la valeur AnalysisWarningCode AnalysisWarningCode _ LanguageIdNotRespected.

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 :: AddStrokesToCustomRecognizer.

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.

IInkAnalyzer retourne un HRESULT d' E _ INVALIDARG dans les circonstances suivantes.

  • Le IInkAnalyzer contient déjà un trait avec le même identificateur que l’un des traits à ajouter.
  • Le paramètre pCustomRecognizer contient un nœud de reconnaissance personnalisé associé à un objet IInkAnalyzer différent.
  • Le paramètre pCustomRecognizer contient un IContextNode qui n’est pas de type CustomRecognizer.

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
IACom. h (nécessite également IACom _ i. c)
DLL
IACom.dll

Voir aussi

IInkAnalyzer

Types de nœuds de contexte

IInkAnalyzer :: AddStrokeToCustomRecognizer, méthode

IInkAnalyzer :: CreateCustomRecognizer, méthode

Référence de l’analyse de l’encre