Méthode IContextNode::Confirm

Modifie le type de confirmation, qui contrôle ce que l’objet IInkAnalyzer peut modifier à propos de l’IContextNode.

Syntaxe

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Paramètres

confirmType [in]

ConfirmationType appliqué au nœud.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse manuscrite.

Notes

Utilisez cette méthode pour permettre à l’utilisateur final de confirmer que le IInkAnalyzer a correctement analysé les traits. Une fois IContextNode::Confirm appelé, IInkAnalyzer ne modifie pas les objets IContextNode pour ces traits lors de l’analyse ultérieure.

Utilisez IContextNode::Confirm lorsque l’utilisateur a confirmé les résultats d’analyse et ne souhaite pas que L’IInkAnalyzer modifie un IContextNode lors d’une analyse ultérieure. Par exemple, si l’utilisateur écrit le mot « à » et que l’application appelle la méthode IInkAnalyzer::Analyze, l’analyseur d’encre génère un nœud InkWord avec la valeur « to ». Si l’utilisateur ajoute ensuite « me » après « à » en tant que mot et que l’application appelle à nouveau la méthode IInkAnalyzer::Analyze , l’analyseur d’encre peut supprimer le nœud InkWord précédent et créer un nœud InkWord avec la valeur « tome ». Toutefois, si après le premier appel à la méthode IInkAnalyzer::Analyze, l’application appelle IContextNode::Confirm sur le nœud InkWord pour « à » avec la valeur ConfirmationTypeNodeTypeAndProperties, avant que l’utilisateur n’ajoute le « me », alors lorsque l’application appelle la méthode IInkAnalyzer::Analyze, l’analyseur d’encre ne supprime pas ou ne modifie pas le nœud « en ». Au lieu de cela, l’analyseur d’encre peut reconnaître deux nœuds InkWord pour « à » et « me ».

IContextNode peut uniquement confirmer les objets de type InkWord et InkDrawing (voir Types de nœuds de contexte). IContextNode::Confirm retourne E_INVALIDARG lorsque le nœud n’est pas un nœud feuille.

La méthode IInkAnalyzer::RemoveStroke et la méthode IInkAnalyzer::RemoveStrokes n’ont pas confirmé tout nœud à partir duquel elles suppriment les données de trait.

IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType et IInkAnalyzer::SetStrokeTyperetournent CORE_E_INVALIDOPERATION si l’objet IContextNode est déjà confirmé.

IContextNode::ReparentStrokeByIdToNode retourne une erreur si le nœud source ou de destination est confirmé.

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

IContextNode

IContextNode::IsConfirmed

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