Funktionreferenz


_IEFormGetObjByName

Beschreibung anzeigen in

Gibt einen Objekt Verweis auf eine Form durch den Namen zurück

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

Parameter

$oObject Objekt-Variable einer InternetExplorer.Application, Fenster oder Frame Objekt
$sName Legt den Namen der Form fest, mit welcher verglichen werden soll
$iIndex [optional] Wenn der Form-Name öfters als 1 Mal auftaucht, bestimmt die Instanz vom 0-basierten Index eine indizierte Instanz.
    0 (Standard) oder eine positive ganze Zahl
    -1 Liefert eine Sammlung der angegebenen Formen

Rückgabewert

Erfolg: eine Objekt Variable, welche auf das Form Objekt verweist, @extended = Form Anzahl
Fehler: Setzt das @error Flag auf ungleich null
@error: 3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp
7 ($_IEStatus_NoMatch) - Keine Übereinstimmung gefunden
@extended: Nummer des ungültigen Parameters

Bemerkungen

Wenn die gewünschte Form nicht über einen Namen oder eine ID verfügt, siehe: _IEFormGetCollection() um einen Verweis vom Index zu erhalten.

Verwandte Funktionen

_IEFormGetCollection, _IEFormReset, _IEFormSubmit

Beispiel

#include <IE.au3>

; Bekommt einen Bezug zu einem bestimmten Input-Control durch dessen Name.
; In diesem Fall zu der Google-Suche. Es ist zu beachten, dass die Namen der Input-Controls und deren Inhalte im Quelltext gefunden werden können.

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