Gibt ein Sammelobjekt zurück, das entweder alle Elemente des Objekts mit dem angegebenen TagName oder ein dem Index entsprechendes Element enthält
#include <IE.au3>
_IETagNameGetCollection ( ByRef $oObject, $sTagName [, $iIndex = -1] )
$oObject | Objektvariable eines InternetExplorer.Application, Fensters, Frame-, iFrame- oder beliebigen Objekts des DOM |
$sTagName | TagName der zurückzugebenden Auflistung (z.B. IMG, TR etc.) |
$iIndex | [optional] Gibt an, ob eine Auflistung oder ein einzelnes Element zurückgegeben werden soll 0 oder positive Ganzzahl gibt das entsprechende Element zurück -1 = (Standard) Gibt eine Auflistung zurück |
Erfolg: | eine Objektvariable, die eine dem Tag entsprechende Auflistung enthält, @extended = Anzahl nach angegebenem Tag |
Fehler: | setzt das @error Flag auf ungleich null |
@error: | 3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp 4 ($_IEStatus_InvalidObjectType) - Ungültiger Objekttyp 5 ($_IEStatus_InvalidValue) - Ungültiger Wert 7 ($_IEStatus_NoMatch) - Keine Übereinstimmung gefunden |
@extended: | Beinhaltet Nummer des ungültigen Parameters |
Das DOM ist hierarchisch angelegt.
Ist das übergebene Objekt das Dokument-Objekt, werden alle dem TagName entsprechenden Elemente des Dokuments zurückgegeben.
st das übergebene Objekt jedoch ein Objekt innerhalb des Dokuments (z.B. ein TABLE-Objekt), werden lediglich alle dem TagName entsprechenden Elemente innerhalb dieses bestimmten Objekts zurückgegeben.
#include <IE.au3>
#include <MsgBoxConstants.au3>
; Öffnet einen Browser mit einem Formular Beispiel,
; Sammelt alle INPUT tags und zeigt sie den Form-Namen, sowie alle Typen dieser an
Local $oIE = _IE_Example("form")
Local $oInputs = _IETagNameGetCollection($oIE, "input")
Local $sTxt = ""
For $oInput In $oInputs
$sTxt &= $oInput.type & @CRLF
Next
MsgBox($MB_SYSTEMMODAL, "Form Input Type", "Form: " & $oInput.form.name & @CRLF & @CRLF & " Types :" & @CRLF & $sTxt)
_IEQuit($oIE)