c = wxmlTag.TagsCount()
Wenn der Returnwert = 0 ist, handelt es sich bei wxmlTag um einen Werte-Tag, dessen Wert mit einer der Funktionen GetBool bis GetStr, GetArray oder GetStrArray abgefragt werden kann. Man kann aber auch direkt auf das Property Value (string) von wxmlTag zugreifen.
Wenn der Returnwert > 0 ist, handelt es sich bei wxmlTag um einen Tag-Knoten. Auf die Sub-Tags dieses Knoten kann über das Property TagList von wxmlTag zugegriffen werden oder über eine der folgenden Funktionen:
i = wxmlTag.FindTag( aName )
Sucht in der TagList des Tags wxmlTag nach dem ersten Tag mit dem Namen aName. Wenn wxmlTag kein Tag-Knoten ist oder kein Tag mit diesem Namen in seiner TagList vorkommt, wird -1 zurück gegeben. Sonst wird der Index (>= 0) des Tags mit dem Namen aName zurückgegeben.
Hinweis: Diese Funktion verwendet eine optimierte Suche. Die Suche ist optimal schnell, wenn die Tags in der Reihenfolge gesucht werden, in der sie in der TagList eingetragen sind.
Diese Funktion wird bei allen Funktionen GetXxxByName verwendet.
set tag = wxmlTag.GetTagByName( aName )
Sucht in der TagList des Tags wxmlTag nach dem ersten Tag mit dem Namen aName. Wenn wxmlTag kein Tag-Knoten ist oder kein Tag mit diesem Namen in seiner TagList vorkommt, wird Nothing zurück gegeben. Andernfalls wird eine Referenz auf den gefundenen Tag zurück gegeben.
Hinweis: Diese Funktion verwendet intern die optimierte Suchfunktion FindTag.
b = wxmlTag.GetBool() i = wxmlTag.GetInt() d = wxmlTag.GetDate() s = wxmlTag.GetStr()
Liest das Property Value des Werte-Tags wxmlTag aus und wandelt es in den entsprechenden Datentyp um:
Hinweis: In Tags werden Werte immer in String-Form gespeichert. Wenn der entsprechende String nicht in den gewünschten Datentyp konvertiert werden kann, wird eine Fehlermeldung (Exception) erzeugt.
arr = wxmlTag.GetArray()
Erzeugt einen Array der gleichen Grösse wie TagList des Tags wxmlTag und gibt ihn zurück. Die Elemente dieses Arrays sind leer.
Hinweis: Diese Funktion wird intern von GetStrArray benötigt. Um auf die Element des wxmlTag zuzugreifen, kann man direkt das Property TagList verwenden.
sArr = wxmlTag.GetStrArray()
Wenn wxmlTag ein Tag-Knoten ist gibt diese Funktion die Werte (Value) der Sub-Tags in einem String-Array zurück. Sonst wird ein leerer Array zurück gegeben.
Diese Funktion ist das Gegenstück zu AddStrArray.
b = wxmlTag.GetBoolByIx( aIx ) i = wxmlTag.GetIntByIx( aIx ) d = wxmlTag.GetDateByIx( aIx ) s = wxmlTag.GetStrByIx( aIx )
Wenn wxmlTag ein Tag-Knoten ist wird der Wert (Value) des Sub-Tags mit dem Index aIx ausgelesen, in den gewünschten Datentyp konvertiert und zurückgegeben. Wenn aIx kein gültiger Index ist, wird eine Fehlermeldung erzeugt (Exception).
Hinweis: In Tags werden Werte immer in String-Form gespeichert. Wenn der entsprechende String nicht in den gewünschten Datentyp konvertiert werden kann, wird eine Fehlermeldung (Exception) erzeugt.
arr = wxmlTag.GetArrayByIx( aIx )
Wenn wxmlTag ein Tag-Knoten ist wird ein Array der gleichen Grösse wie TagList des Elementes TagList(aIx) des Tags wxmlTag erzeugt und zurück gegeben. Die Elemente dieses Arrays sind leer. Wenn aIx kein gültiger Index ist, wird eine Fehlermeldung erzeugt (Exception).
Hinweis: Diese Funktion wird intern von GetStrArrayByIx benötigt.
sArr = wxmlTag.GetStrArrayByIx( aIx )
Wenn wxmlTag ein Tag-Knoten ist gibt diese Funktion ein Array der gleichen Grösse wie TagList des Elementes E = TagList(aIx) des Tags wxmlTag zurück. Das Element E ist in der Regel ebenfalls ein Tag-Konten. In diesem Fall wird der Array mit den Werten der Sub-Tags von E gefüllt.
Wenn aIx kein gültiger Index ist, wird eine Fehlermeldung erzeugt (Exception).
Diese Funktion ist das Gegenstück zu AddStrArray.
b = wxmlTag.GetBoolByName( aName, aDefVal ) i = wxmlTag.GetIntByName( aName, aDefVal ) d = wxmlTag.GetDateByName( aName, aDefVal ) s = wxmlTag.GetStrByName( aName, aDefVal )
Wenn wxmlTag ein Tag-Knoten ist wird der Wert (Value) des Sub-Tags mit dem Namen aName ausgelesen, in den gewünschten Datentyp konvertiert und zurückgegeben. Wenn kein Tag aName in der TagList von wxmlTag vorkommt, wird aDefVal zurückgegeben.
Hinweis: In Tags werden Werte immer in String-Form gespeichert. Wenn der entsprechende String nicht in den gewünschten Datentyp konvertiert werden kann, wird eine Fehlermeldung (Exception) erzeugt.
Hinweis: Diese Funktion verwendet eine optimierte Suche. Die Suche ist optimal schnell, wenn die Tags in der Reihenfolge abgefragt werden, in der sie in der TagList eingetragen sind.
arr = wxmlTag.GetArrayByName( aName )
Wenn wxmlTag ein Tag-Knoten ist wird ein Array der gleichen Grösse wie TagList des Elementes TagList(aName) des Tags wxmlTag erzeugt und zurück gegeben. Die Elemente dieses Arrays sind leer. Wenn kein Tag aName in der TagList von wxmlTag vorkommt, wird ein leerer Array zurückgegeben.
Hinweis: Diese Funktion wird intern von GetStrArrayByName benötigt.
sArr = wxmlTag.GetStrArrayByName( aName )
Wenn wxmlTag ein Tag-Knoten ist gibt diese Funktion ein Array der gleichen Grösse wie TagList des Elementes E = TagList(aName) des Tags wxmlTag zurück. Das Element E ist in der Regel ebenfalls ein Tag-Konten. In diesem Fall wird der Array mit den Werten der Sub-Tags von E gefüllt.
Wenn kein Tag aName in der TagList von wxmlTag vorkommt, wird ein leerer Array zurückgegeben.
Diese Funktion ist das Gegenstück zu AddStrArray.