Funktionreferenz


_IETagNameGetCollection

Beschreibung anzeigen in

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] )

Parameter

$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

Rückgabewert

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

Bemerkungen

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.

Verwandte Funktionen

_IETagNameAllGetCollection

Beispiel

#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)