Xml.XMLDoc.TNodeListNotification

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

TNodeListNotification = procedure(Operation: TNodeListOperation;
var Node: IXMLNode; const IndexOrName: OleVariant;
BeforeOperation: Boolean) of Object;

C++

typedef void __fastcall (__closure *TNodeListNotification)(TNodeListOperation Operation, Xml::Xmlintf::_di_IXMLNode &Node, const System::OleVariant &IndexOrName, bool BeforeOperation);

Propriétés

Type Visibilité  Source Unité  Parent
type
typedef
public
Xml.XMLDoc.pas
Xml.XMLDoc.hpp
Xml.XMLDoc Xml.XMLDoc

Description

TNodeListNotification représente le type du callback appelé par l'objet TXMLNodeList lorsqu'il ajoute, supprime ou crée des noeuds XML.

TNodeListNotification est le type du callback fourni à TXMLNodeList dans son constructeur. TXMLNodeList appelle cette procédure avant et après l'ajout ou la suppression de noeuds dans la liste et lors de la création d'un noeud.

Operation indique la modification qui est sur le point de se produire ou qui vient d'avoir lieu.

Node spécifie le noeud faisant l'objet de cette modification. Son utilisation dépend de l'opération, comme l'explique le tableau suivant :



Opération Noeud

nlInsert

Noeud sur le point d'être ajouté ou qui vient d'être ajouté à la liste.

nlRemove

Noeud sur le point d'être supprimé ou qui vient d'être supprimé de la liste.

nlCreateNode

Noeud nouvellement créé. Il doit être créé par le callback et renvoyé en tant que paramètre Node.

ntElement

Nom de balise.

ntAttribute

Nom de l'attribut.

ntText

Valeur du noeud.

ntCData

Valeur de la section CDATA.

ntEntityRef

Nom de l'entité référencée.

ntProcessingInstr

Cible de l'instruction de traitement.

ntComment

Valeur (texte) du commentaire.

ntDocFragment

Inutilisé.



IndexOrName n'est utilisé que lorsque Operation a pour valeur nlCreateNode. Il s'agit de la valeur affectée à la propriété Nodes à partir de l'indice d'un noeud qui n'existe pas encore. L'interprétation de IndexOrName dépend du type de noeud créé par le callback, comme l'explique le tableau suivant :



NodeType IndexOrName

ntElement

Nom de balise.

ntAttribute

Nom de l'attribut.

ntText

Valeur du noeud.

ntCData

Valeur de la section CDATA.

ntEntityRef

Nom de l'entité référencée.

ntProcessingInstr

Cible de l'instruction de traitement.

ntComment

Valeur (texte) du commentaire.

ntDocFragment

Inutilisé.



BeforeOperation indique si le callback se produit avant ou après l'opération indiquée. Lorsque des noeuds sont insérés et supprimés, le callback est d'abord appelé avec BeforeOperation définie à true, l'opération se produit puis un second callback est effectué avec BeforeOperation définie à false. Lorsque des noeuds doivent être créés, seul un appel est effectué, avec BeforeOperation définie à true.

Voir aussi