Funktionreferenz


_IEFormElementGetObjByName

Beschreibung anzeigen in

Gibt die Objektreferenz auf ein, über den Namen bestimmtes, Formular-Element zurück

#include <IE.au3>
_IEFormElementGetObjByName ( ByRef $oObject, $sName [, $iIndex = 0] )

Parameter

$oObject Objekt Variable einer InternetExplorer.Application, Form Objekt
$sName Der Namen des gewünschten Formular-Elements.
$iIndex [optional] Der Index (0-basiert) wenn der Namen des Formular-Elements mehrfach vergeben ist
    0 (Standard) oder eine positive Zahl die den Index des Elements bestimmt
    -1 gibt eine Sammlung des angegebenen Formular-Elements zurück

Rückgabewert

Erfolg: eine Objektvariable die auf das Formular-Element hinweist, @extended = Anzahl Formular-Elemente
Fehler: Setzt das @error Flag auf ungleich null
@error: 3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp
4 ($_IEStatus_InvalidObjectType) - Ungültiger Objekttyp
7 ($_IEStatus_NoMatch) - Keine Übereinstimmung gefunden
@extended: Nummer des ungültigen Parameters

Bemerkungen

Wenn das gewünschte Formular-Element weder Namen noch ID hat, bekommt man über _IEFormElementGetCollection() eine Sammlung aller Formular-Elemente.

Verwandte Funktionen

_IEFormElementGetCollection, _IEFormElementGetValue, _IEFormElementSetValue, _IEFormSubmit

Beispiel

#include <IE.au3>

; Erhält einen Bezug zu einem bestimmten Formelement durch den Namen
; In diesem Fall wird eine Eingabe in der Google Suchmaschine getätigt

Local $oIE = _IECreate("http://www.google.de")
Local $oForm = _IEFormGetObjByName($oIE, "gbqf")
Local $oQuery = _IEFormElementGetObjByName($oForm, "q")
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)