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 |
|
| DLL |
|