_IEGetObjByName
Beschreibung anzeigen in
Gibt eine Objektvariable anhand des Namens des Objektes zurück
#include <IE.au3>
_IEGetObjByName ( ByRef $oObject, $sName [, $iIndex = 0] )
Parameter
| $oObject | Objektvariable einer InternetExplorer.Application, eines Window- oder eines Frameobjekts |
| $sName | Name des Objektes, das erfasst werden soll |
| $iIndex | [optional] Wenn mehrere Objekte dieses Namens existieren, können die einzelnen Objekte hiermit per 0-basiertem positivem Index ausgewählt werden 0 = Standard = erstes Objekt. -1 = Gibt eine Auflistung der gefundenen Objekte zurück. |
Rückgabewert
| Erfolg: | eine Objektvariable, die auf das gewählte Objekt verweist, @extended = Objektnummer |
| 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
Diese Funktion gibt eine Referenz auf ein Objekt zurück, das den angegebenen Namen oder die angegebene ID trägt.
DOM-Objekte können als Attribute den Namen, die ID oder beides zusammen haben.
Eine ID kann nur jeweils einmal vergeben werden, während der Name von mehreren Elementen verwendet werden kann.
Im Internet Explorer werden der Name und ID im gleichen Namensraum verwendet.
Verwandte Funktionen
Beispiel
#include <IE.au3>
#include <MsgBoxConstants.au3>
;Öffnet einen Browser mit dem form-Beispiel und bekommt einen Objektbezug zu dem Element mit dem Namen "ExampleForm". In diesem Fall ist das Ergebnis identisch mit $oForm = _IEFormGetObjByName($oIE, "ExampleForm").
Local $oIE = _IE_Example("form")
Local $oForm = _IEGetObjByName($oIE, "ExampleForm")
MsgBox($MB_SYSTEMMODAL, "ExampleForm", _IEPropertyGet($oForm, "innertext") & @CRLF)