Xml.XMLDoc.TNodeListNotification
C++
typedef void __fastcall (__closure *TNodeListNotification)(TNodeListOperation Operation, Xml::Xmlintf::_di_IXMLNode &Node, const System::OleVariant &IndexOrName, bool BeforeOperation);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
typedef | public | Xml.XMLDoc.hpp | Xml.XMLDoc | Xml.XMLDoc |
Beschreibung
TNodeListNotification wird für die Callback-Routine verwendet, die von TXMLNodeList beim Hinzufügen, Entfernen und Erstellen von XML-Knoten aufgerufen wird.
TNodeListNotification ist der Typ der Callback-Routine, die an den Konstruktor von TXMLNodeList übergeben wird. Diese Prozedur wird von den TXMLNodeList-Objekten aufgerufen, bevor und nachdem ein Knoten hinzugefügt, entfernt oder erstellt wird.
Operation gibt die jeweilige Operation an.
Node gibt den Knoten an, mit dem die Operation durchgeführt wird. Der Wert hängt vom Parameter Operation ab:
Operation | Node |
---|---|
nlInsert |
Der Knoten wird (wurde) in die Liste aufgenommen. |
nlRemove |
Der Knoten wird (wurde) aus der Liste entfernt. |
nlCreateNode |
Der neu erstellte Knoten. Dieser sollte in der Callback-Routine erstellt und in Node zurückgegeben werden. |
ntElement |
Der Tag-Name. |
ntAttribute |
Der Name des Attributs. |
ntText |
Der Wert des Knotens. |
ntCData |
Der Inhalt des CDATA-Abschnitts. |
ntEntityRef |
Der Name der referenzierten Entität. |
ntProcessingInstr |
Das Ziel der Verarbeitungsanweisung. |
ntComment |
Der Wert (Text) des Kommentars. |
ntDocFragment |
Wird nicht verwendet. |
IndexOrName wird nur verwendet, wenn Operation den Wert nlCreateNode hat. Der Wert wird der Eigenschaft Nodes mit dem Index eines Knotens zugewiesen, der noch nicht vorhanden ist. Die Bedeutung von IndexOrName hängt vom Typ des Knotens ab, der in der Callback-Routine erstellt wird:
NodeType | IndexOrName |
---|---|
ntElement |
Der Tag-Name. |
ntAttribute |
Der Name des Attributs. |
ntText |
Der Wert des Knotens. |
ntCData |
Der Inhalt des CDATA-Abschnitts. |
ntEntityRef |
Der Name der referenzierten Entität. |
ntProcessingInstr |
Das Ziel der Verarbeitungsanweisung. |
ntComment |
Der Wert (Text) des Kommentars. |
ntDocFragment |
Wird nicht verwendet. |
BeforeOperation gibt an, ob der Aufruf vor (true) oder nach (false) der angegebenen Operation erfolgt. Beim Hinzufügen und Entfernen von Knoten wird die Callback-Routine mit true aufgerufen und anschließend die Operation durchgeführt. Am Ende findet ein zweiter Aufruf mit false statt. Wenn Knoten erstellt werden müssen, wird nur ein Aufruf mit true durchgeführt.