Funktionsreferenz

_IEFormElementGetObjByName

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

#include <IE.au3>
_IEFormElementGetObjByName(ByRef $o_object, $s_name [, $i_index = 0])

Parameter

$o_object Objekt Variable einer InternetExplorer.Application, Form Objekt
$s_name Der Namen des gewünschten Formular-Elements.
$i_index [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: Gibt eine Objektvariable zurück die auf das Formular-Element hinweist, @EXTENDED = Anzahl Formular-Elemente
Fehler: Gibt 0 zurück und setzt @ERROR
@Error: 0 ($_IEStatus_Success) = Kein Fehler
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


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

#include <IE.au3>

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