_IEFormElementCheckBoxSelect

Beschreibung anzeigen in

Setzt den Wert des angegebenen Formitems

#include <IE.au3>
_IEFormElementCheckBoxSelect ( ByRef $oObject, $sString [, $sName = "" [, $iSelect = 1 [, $sMode = "byValue" [, $iFireEvent = 1]]]] )

Parameter

$oObject	Objekt Variable von einer Internet Explorer Anwendung, Formular Objekt
$sString	Wert wird zum Vergleichen von Elementen genutzt - Behandlungsweise basiert auf $sMode
$sName	[optional] Name oder ID der Checkbox(en)
$iSelect	[optional] bestimmt ob ein Element gewählt oder abgewählt werden soll -1 = gibt den Zustand zurück 0 = wählt das Element ab 1 = (Standard) wählt das Element aus
$sMode	[optional] spezieller Suchmodus "byValue" = (Standard) Wert der Checkbox, die man auswählen möchte "byIndex" = 0-basierter Index der Checkbox, die man auswählen möchte
$iFireEvent	[optional] spezifiziert ob man ein OnChange und OnClick Ereignis, auslösen möchte, nachdem man den Wert geändert hat 0 = nicht auslösen eines OnChange oder OnClick Ereignisses nach setzen des Wertes 1 = (Standard) auslösen eines OnChange oder OnClick Ereignisses nach setzen des Wertes

Rückgabewert

Erfolg:	Wenn $iSelect = -1, dann gibt die Funktion den momentanen Zustand zurück, anderenfalls eine 1.
Fehler:	0 und setzt das @error Flag auf ungleich null.
@error:	3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp 4 ($_IEStatus_InvalidObjectType) - Ungültiger Objekttyp 5 ($_IEStatus_InvalidValue) - Ungültiger Wert 7 ($_IEStatus_NoMatch) - Keine Übereinstimmung gefunden
@extended:	Beinhaltet Nummer des ungültigen Parameters

Bemerkungen

Der $iFireEvent Parameter ist nur bedeutend, wenn das Formelement mit einem onChange Ereignis verbunden ist.

$sName ist optional für diese Funktion.
Wenn man es auslässt, wird die Funktion auf alle vorhandenen Elemente vom Typ in dem Formular angewendet.
Wenn man es angibt wird diese Funktion auf alle Elemente vom Typ mit diesem Namen angewendet.

Beispiel

Beispiel 1

; Öffnet einen Browser mit einer Beispiel-Form, bestimmt den Verweis der Form,
; Wählt den byValue-Wert der Checkboxen aus und  wieder ab.
; Wenn $s_Name nicht spezifiziert ist, arbeitet es mit der Auswahl aller <input type=checkbox> Elemente in der Form.
; Es ist folgendes zu beachten: Es muss wahrscheinlich in der Seite runtergescrollt werden um die Veränderungen zu sehen

#include <IE.au3>

Local $oIE = _IE_Example("Form")
Local $oForm = _IEFormGetObjByName($oIE, "Beispiel-Form")
For $i = 1 To 3
    _IEFormElementCheckBoxSelect($oForm, "Basketball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Fußball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Tennis", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Baseball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Basketball", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Fußball", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Tennis", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "Baseball", "", 0, "byValue")
    Sleep(1000)
Next

_IEQuit($oIE)

Beispiel 2

#include <IE.au3>

; Öffnet einen Browser mit einer Beispiel-Form, bestimmt den Verweis der Form,
; Wählt den byIndex-Wert der Checkboxen aus und  wieder ab. Wenn $s_Name nicht spezifiziert ist, arbeitet es
; Mit der Auswahl aller <input type=checkbox> Elemente in der Form
; Es ist folgendes zu beachten: Es muss wahrscheinlich in der Seite runtergescrollt werden um die Veränderungen zu sehen

Local $oIE = _IE_Example("Form")
Local $oForm = _IEFormGetObjByName($oIE, "Beispiel-Form")
For $i = 1 To 5
    _IEFormElementCheckBoxSelect($oForm, 3, "", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 2, "", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 1, "", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 0, "", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 3, "", 0, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 2, "", 0, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 1, "", 0, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 0, "", 0, "byIndex")
    Sleep(1000)
Next

_IEQuit($oIE)

Beispiel 3

#include <IE.au3>

; Öffnet einen Browser mit der Beispiel-Form, bestimmt den Verweis der Form,
; Wählt die byIndex-Werte der Checkboxen in der Gruppe, die sich den Namen  checkboxG2Example teilt, aus und wieder ab
; Es ist folgendes zu beachten: Es muss wahrscheinlich in der Seite runtergescrollt werden um die Veränderungen zu sehen

Local $oIE = _IE_Example("Form")
Local $oForm = _IEFormGetObjByName($oIE, "Beispiel-Form")
For $i = 1 To 5
    _IEFormElementCheckBoxSelect($oForm, 0, "checkboxG2Example", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 1, "checkboxG2Example", 1, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 0, "checkboxG2Example", 0, "byIndex")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, 1, "checkboxG2Example", 0, "byIndex")
    Sleep(1000)
Next

_IEQuit($oIE)

Funktionreferenz