Xml.XMLDoc.TNodeListNotification
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.