IContextNode :: Confirm, méthode

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

Syntaxe

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Paramètres

confirmedType [ dans]

ConfirmationType appliqué au nœud.

Valeur de retour

Pour obtenir une description des valeurs de retour, consultez classes et interfaces-analysede l’encre.

Notes

Utilisez cette méthode pour permettre à l’utilisateur final de confirmer que le IInkAnalyzer a correctement analysé les traits. Après l’appel de IContextNode :: Confirm , le 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 de l’analyse et ne veut pas que le IInkAnalyzer change un IContextNode lors de l’analyse ultérieure. Par exemple, si l’utilisateur écrit le mot « vers », puis 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 « to » comme un seul mot et que l’application appelle de nouveau la méthode IInkAnalyzer :: Analyze , l’analyseur d’encre peut supprimer le nœud InkWord précédent et créer un nouveau 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 « to » avec la valeur ConfirmationType NodeTypeAndProperties, avant que l’utilisateur n’ajoute le « me », quand l’application appelle la méthode IInkAnalyzer :: Analyze, l’analyseur d’encre ne supprime pas ou ne modifie pas le nœud « to ». À la place, l’analyseur d’encre peut reconnaître deux nœuds InkWord pour « to » et « me ».

IContextNode peut uniquement confirmer les objets de type InkWord et InkDrawing (consultez types de nœuds de contexte). IContextNode :: Confirm retourne E _ INVALIDARG lorsque le nœud n’est pas un nœud terminal.

Les méthodes IInkAnalyzer :: RemoveStroke et IInkAnalyzer :: RemoveStrokes déconfirment les nœuds à partir desquels ils suppriment les données de trait.

IContextNode :: SetStrokes, IInkAnalyzer :: SetStrokesTypeet IInkAnalyzer :: SetStrokeType retournent le biais du 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 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

IContextNode

IContextNode::IsConfirmed

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