Count
Osztály: IXMLNodeList
property Count: Integer;
A listában szereplő csomópontok számát adja vissza ez a property. A csomópontok száma meghatározza a Nodes property-nél használható index maximális értékét is.
Nodes
Osztály: IXMLNodeList
property Nodes[const IndexOrName: OleVariant]: IXMLNode;
Ezen a tömb property-n keresztül érhetjük el egy csomópont IXMLNode típusú objektumát. Indexként megadhatjuk a csomópont sorszámát (0-tól Count-1-ig), vagy a csomópont nevét.
Ha a megadott nevű csomópont nem létezik, és a dokumentum Options property-je (lásd TXMLDocument osztály) tartalmazza a doNodeAutoCreate tulajdonságot, akkor megpróbálja létrehozni a csomópontot. Ha nem sikerül, akkor kivétel keletkezik.
UpdateCount
Osztály: IXMLNodeList
property UpdateCount: Integer;
Ebből a property-ből kiolvasható, hogy az alkalmazás hányszor hívta meg a BeginUpdate metódust, amelyet még nem zárt le az EndUpdate metódussal. Ha az értéke nagyobb, mint 0, akkor még vannak olyan módosítások, amelyek nem lettek véglegesítve.
Megjegyzés
A BeginUpdate eljárás minden meghíváskor 1-gyel növeli a property értékét, míg az EndUpdate eljárás 1-gyel csökkenti azt. Az alkalmazás a módosítás megkezdése előtt meghívja a BeginUpdate metódust, és a módosítások elvégzése után az EndUpdate eljárást. A BeginUpdate és EndUpdate eljárások tetszés szerint egymásba is ágyazhatók.
Add
Osztály: IXMLNodeList
function Add(
const Node: IXMLNode
): Integer;
A függvény a lista végére beszúr egy új csomópontot.
Paraméterek
const Node: IXMLNode
A listába felveendő csomópont IXMLNode típusú objektuma.
Visszatérési érték
A visszatérési értéke a felvett csomópont indexe. Ha ez volt az első csomópont, akkor 0, ha a második, akkor 1, és így tovább.
BeginUpdate
Osztály: IXMLNodeList
procedure BeginUpdate;
Ha több módosítást végzünk az objektumon, akkor hívjuk meg ezt az eljárást (pl. több csomópont hozzáadása vagy törlése). Az eljárás növeli az UpdateCount property értékét, ezért a módosítások befejezésekor minden esetben meg kell hívni az EndUpdate eljárást.
EndUpdate
Osztály: IXMLNodeList
procedure EndUpdate;
A módosítások megkezdése előtt meghívott BeginUpdate eljárást zárhatjuk le ezzel az eljárással. Minden BeginUpdate eljáráshoz kell tartozni egy EndUpdate eljárásnak.
Az EndUpdate csökkenti az UpdateCount property értékét 1-gyel.
Clear
Osztály: IXMLNodeList
procedure Clear;
Az eljárás törli az összes csomópontot a listából. Az eljárás nem hívja meg automatikusan a BeginUpdate és EndupDate eljárásokat, még akkor sem, ha több csomópont kerül törlésre.
Delete
Osztály: IXMLNodeList
function Delete(
const Name: DOMString
): Integer; overload;
A függvény törli a megadott nevű vagy indexű csomópontot a listából. Három változata van:
function Delete(const Name: DOMString): Integer; overload;
function Delete(const Name, NamespaceURI: DOMString): Integer; overload;
function Delete(const Index: Integer): Integer; overload;
Az első változatnál csak a csomópont nevét, míg a másodiknál a névtér URI azonosítóját is meg kell adni. A harmadik változatban csak a csomópont indexét kell megadni.
Paraméterek
const Name: DOMString
A csomópont neve.
const NamespaceURI: DOMString
A csomópont névterének URI azonosítója.
const Index: Integer
A csomópont indexe.
Visszatérési érték
A visszatérési érték a törölt csomópont indexe. Ha valami miatt nem történt törlés (pl. a megadott nevű csomópont nem létezett), akkor a visszatérési érték –1.
FindNode
Osztály: IXMLNodeList
function FindNode(
NodeName: DOMString
): IXMLNode; overload;
A függvény megkeresi a paraméterek által meghatározott csomópontot, és annak IXMLNode típusú objektumával tér vissza. A függvénynek három változata is van:
function FindNode(NodeName: DOMString): IXMLNode; overload;
function FindNode(NodeName, NamespaceURI: DOMString): IXMLNode; overload;
function FindNode(ChildNodeType TGuid): IXMLNode; overload;
Paraméterek
NodeName: DOMString
A csomópont neve a névtér előtag nélkül.
NamespaceURI: DOMString
A csomópont névterének URI azonosítója.
ChildNodeType TGuid
A csomópont interfész típusának azonosítója (GUID).
Visszatérési érték
A megtalált csomópont IXMLNode objektumával tér vissza. Ha nem találta meg a keresett csomópontot, akkor a visszatérési értéke nil.
FindSibling
Osztály: IXMLNodeList
function FindSibling(
const Node: IXMLNode;
Delta: Integer
): IXMLNode;
A paraméterek által meghatározott testvér elem IXMLNode típusú objektumával tér vissza. A pozíciót egy referencia csomóponttal, és az ahhoz viszonyított relatív pozícióval kell megadni.
Paraméterek
const Node: IXMLNode
A referenciapontként használt csomópont objektuma.
Delta: Integer
A referenciapontként használt csomópont pozíciójához mért relatív pozíció. Ha ez a pozíció pozitív, akkor a csomópont utáni Delta távolságban lévő testvér csomópontot adja vissza, negatív Delta esetén pedig a csomópont előttit. Ha a Delta paraméter értéke 0, akkor a referenciapontként használt csomópontot kapjuk vissza (Node paraméter). Ha például a Node paraméterben megadott csomópont indexe 5, a Delta paraméter értéke pedig –2, akkor azt a csomópontot kapjuk meg, amelynek indexe 3.
Visszatérési érték
A visszatérési érték e megtalált csomópont IXMLNode objektuma. Ha a két paraméter által meghatározott indexű csomópont nem létezik, akkor a visszatérési érték nil.
First
Osztály: IXMLNodeList
function First: IXMLNode;
A listában lévő első csomópont IXMLNode objektumával tér vissza.
GetCount
Osztály: IXMLNodeList
function GetCount: Integer;
A Count property read metódusa.
Visszatérési érték
A listában lévő csomópontok számát adja vissza.
GetNode
Osztály: IXMLNodeList
function GetNode(
const IndexOrName: OleVariant
): IXMLNode;
A Node property read metódusa.
Paraméterek
const IndexOrName: OleVariant
Ebben a paraméterben megadhatjuk a csomópont sorszámát (0-tól Count-1-ig), vagy a csomópont nevét.
Ha a megadott nevű csomópont nem létezik, és a dokumentum Options property-je (lásd TXMLDocument osztály) tartalmazza a doNodeAutoCreate tulajdonságot, akkor megpróbálja létrehozni a csomópontot. Ha nem sikerül, akkor kivétel keletkezik.
Visszatérési érték
A csomópont IXMLNode objektumával tér vissza.
GetUpdateCount
Osztály: IXMLNodeList
function GetUpdateCount: Integer;
Az UpdateCount property read metódusa.
Visszatérési érték
Az UpdateCount property értéke, vagyis az EndUpdate eljárással le nem zárt BeginUpdate hívások száma.
IndexOf
Osztály: IXMLNodeList
function IndexOf(
const Name: DomString
): Integer; overload;
A paraméterek által meghatározott csomópont indexét adja vissza a függvény. A csomópontot háromféleképpen is megadhatjuk, mivel a függvénynek három változata van:
function IndexOf(const Name: DomString): Integer; overload;
function IndexOf(const Name, NamespaceURI: DomString): Integer; overload;
function IndexOf(const Node: IXMLNode): Integer; overload;
Paraméterek
const Name: DomString
A csomópont neve.
const NamespaceURI: DomString
A csomópont névterének URI azonosítója.
const Node: IXMLNode
A csomópont IXMLNode típusú objektuma.
Visszatérési érték
A csomópont indexe, vagy ha a csomópont nem található a listában, akkor –1.
Insert
Osztály: IXMLNodeList
procedure Insert(
Index: Integer;
const Node: IXMLNode
);
Beszúr egy új csomópontot a megadott pozícióba.
Paraméterek
Index: Integer
Az új csomópont pozíciója a listán belül. Ha az index nem megfelelő, akkor kivétel keletkezik.
const Node: IXMLNode
A csomópont IXMLNode objektuma.
Last
Osztály: IXMLNodeList
function Last: IXMLNode;
A lista utolsó csomópontjának IXMLNode objektumával tér vissza.
Remove
Osztály: IXMLNodeList
function Remove(
const Node: IXMLNode
): Integer;
Törli a megadott csomópontot a listából.
Paraméterek
const Node: IXMLNode
A törlendő csomópont IXMLNode objektuma.
Visszatérési érték
A törölt csomópont indexével tér vissza. Ha a csomópont nem volt a listában, akkor a visszatérési érték –1.
ReplaceNode
Osztály: IXMLNodeList
function ReplaceNode(
const OldNode,
NewNode: IXMLNode
): IXMLNode;
A megadott csomópontot helyettesíti egy másik csomóponttal.
Paraméterek
const OldNode
A helyettesítendő csomópont IXMLNode típusú objektuma. Ha ez nem található meg a listában, akkor a NewNode paraméterben megadott csomópont a lista végére lesz beszúrva.
NewNode: IXMLNode
Az új objektum objektuma. Erre lesz felcserélve az OldNode paraméterben megadott csomópont.
Visszatérési érték
Az OldNode paraméterben megadott objektumot adja vissza még akkor is, ha ez nem található meg a listában.