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