Méthode IContextNode::ReparentStrokeByIdToNode
Déplace les données de trait de cet IContextNode vers l’IContextNode spécifié.
Syntaxe
HRESULT ReparentStrokeByIdToNode(
[in] LONG lStrokeId,
[in] IContextNode *pContextNodeDestination
);
Paramètres
-
lStrokeId [in]
-
Identificateur du trait à déplacer.
-
pContextNodeDestination [in]
-
Objet IContextNode vers lequel déplacer les données de trait.
Valeur retournée
Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse manuscrite.
Notes
L’objet IContextNode spécifié doit être l’un des types suivants des constantes Types de nœuds de contexte : InkWord, InkDrawing, InkBullet ou UnclassifiedInk. La tentative de déplacement d’un trait vers un autre type d’objet IContextNode entraîne une valeur de retour de E_INVALIDARG.
Cette méthode peut être appelée à partir de n’importe quel objet IContextNode , y compris les objets IContextNode non manuscrits. Le trait spécifié doit être référencé par l’un des descendants de cet objet IContextNode ou E_INVALIDARG est retourné.
Si cet IContextNode ou IContextNode dans pContextNodeDestination est confirmé, E_INVALIDARG est retourné (voir IContextNode::IsConfirmed).
L’analyseur d’encre ne supprime pas les nœuds de contexte vides de son arborescence de résultats en réponse à cette méthode.
- Un nœud feuille manuscrite qui ne référence aucune donnée de trait est un nœud vide.
- Un nœud de conteneur qui ne référence aucun nœud enfant est un nœud vide.
Un nœud vide génère des erreurs s’il se trouve dans l’arborescence pendant une opération d’analyse d’encre. Pour supprimer un nœud de l’arborescence de l’analyseur d’encre, appelez la méthode IContextNode::D eleteSubNode du nœud parent (voir IContextNode::GetParentNode).
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 |
|
| DLL |
|