Méthode IInkAnalyzer::AddStrokeToCustomRecognizer

Article
06/13/2023

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

Syntaxe

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Paramètres

ulStrokeId [in]: Identificateur du trait à ajouter.
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 de paquet dans chaque paquet.
pStrokePacketDescriptionGuids [in]: Tableau contenant les identificateurs de propriété de paquet.
pCustomRecognizer [in]: IContextNode de type CustomRecognizer auquel ajouter le trait.
ppContextNodeStrokeAddedTo [out]: IContextNode auquel l’analyseur d’encre a ajouté le trait.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse 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 CustomRecognizer (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 du thread d’entrée actif au trait et ajoute le trait au premier nœud UnclassifiedInk sous le nœud CustomRecognizer. S’il n’existe aucun nœud UnclassifiedInk , il est créé. Si le IInkAnalysisRecognizer associé au nœud CustomRecognizer ne prend pas en charge l’identificateur de culture, IInkAnalyzer continue l’analyse et génère un avertissement IAnalysisWarning . Cet avertissement a une valeur AnalysisWarningCodede AnalysisWarningCode_LanguageIdNotRespected.

plStrokePacketData contient des données de paquet 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 de chaque trait. Pour obtenir la liste complète des propriétés de paquet disponibles, consultez Constantes PacketPropertyGuids.

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

IInkAnalyzer retourne un HRESULT de E_INVALIDARG dans les circonstances suivantes.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet 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
Types de nœuds de contexte
IInkAnalyzer::AddStrokesToCustomRecognizer, méthode
IInkAnalyzer::CreateCustomRecognizer, méthode
Informations de référence sur l’analyse manuscrite

Partager via