Méthode IContextNode::ReparentStrokeByIdToNode

  • Article

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
IACom.h (nécessite également IACom_i.c)
DLL
IACom.dll

Voir aussi

IContextNode

IContextNode::SetStrokes

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