_IEFormImageClick

Beschreibung anzeigen in

Simuliert einen Mausklick auf ein <input type=image>. Das Bild kann durch den Alternativtext (Attribut alt), den Namen (Attribut name) und den Quellpfad (Attribut src) identifiziert werden

#include <IE.au3>
_IEFormImageClick ( ByRef $oObject, $sLinkText [, $sMode = "src" [, $iIndex = 0 [, $iWait = 1]]] )

Parameter

$oObject	Objektvariable eines DOM-Elements (es wird in das passende Objekt umgewandelt)
$sLinkText	Wert, anhand dessen das Element identifiziert werden soll - im Bezug auf $sMode
$sMode	[optional] Bestimmt die Suchmethode "src" = (Standard) Bild wird nach seiner Quelle identifiziert "id" = Bild wird anhand seiner ID identifiziert (siehe Bemerkungen) "alt" = Bild wird an Hand seines Alternativtextes identifiziert
$iIndex	[optional] Gibt an, welches Bild angeklickt werden soll, wenn mehrere Bilder mit den gleichen Daten auftauchen (Index beginnt bei 0).
$iWait	[optional] Gibt an, ob gewartet werden soll bis die Seite geladen wird. 0 = Nicht warten. 1 = (Standard) Warten bis die Seite komplett geladen ist.

Rückgabewert

Erfolg:	Nichts.
Fehler:	Gibt 0 oder -1 zurück und setzt das @error-Flag ungleich 0.
@error:	1 ($_IEStatus_GeneralError) - Allgemeiner Fehler 2 ($_IEStatus_COMError) - COM Error in Objektreferenz 3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp 4 ($_IEStatus_InvalidObjectType) - Ungültiges Objekt 5 ($_IEStatus_InvalidValue) - Ungültiger Wert 6 ($_IEStatus_LoadWaitTimeout) - Ladezeit überschritten 7 ($_IEStatus_NoMatch) - Nichts gefunden 8 ($_IEStatus_AccessIsDenied) - Zugriff verweigert 9 ($_IEStatus_ClientDisconnected) - Verbindung abgebrochen
@extended:	Beinhaltet Nummer des ungültigen Parameters

Bemerkungen

Das Formularelement <input type=image> wird anders als alle anderen Formularelemente behandelt.
Es wird vom IE nicht als Teil der Formularelemente angesehen. Deshalb ermöglicht diese Funktion den Zugriff über die Attribute src, name oder alt.
Unabhängig davon, welches Objekt der Funktion übergeben wird, wird das Formularelement stets im gesamten Dokument gesucht.

"name" wird nicht mehr unterstützt, wenn HTML5 verwendet wird. Jedoch wird es weiterhin akzeptiert und entspricht "id" für HTML5 Seiten.

Beispiel

Beispiel 1

#include <IE.au3>

; Öffnet einen Browser mit dem form-Beispiel; Klick auf das <input type=image> Formularelement mit übereinstimmendem Alternativtext ("alt")

Local $oIE = _IE_Example("form")
_IEFormImageClick($oIE, "AutoIt Homepage", "alt")

Beispiel 2

#include <IE.au3>

; Öffnet einen Browser mit dem form-Beispiel; Klick auf das <input type=image> Formularelement mit übereinstimmendem img-Quelltext in der URL (Teilstring)

Local $oIE = _IE_Example("form")
_IEFormImageClick($oIE, "autoit_6_240x100.jpg", "src")

Beispiel 3

#include <IE.au3>

; Öffnet einen Browser mit dem form-Beispiel; Klick auf das <input type=image> Formularelement mit übereinstimmendem Namen

Local $oIE = _IE_Example("form")
_IEFormImageClick($oIE, "imageExample", "name")

Funktionreferenz