Функция _IEFormElementCheckBoxSelect

 ↑  ←  Описание функции

_IEFormElementCheckBoxSelect

Устанавливает значение указанного элемента формы.

#include <IE.au3>
_IEFormElementCheckBoxSelect(ByRef $o_object, $s_string [, $s_name = "" [, $f_select = 1 [, $s_mode = "byValue" [, $f_fireEvent = 1]]]])

Параметры

$o_object Переменная объекта InternetExplorer.Application, Form object
$s_string Значение для сопоставления элемента - основывается на $s_mode
$s_name [необязательный] Имя "name" или Id чекбокса(ов)
$f_select [необязательный] Определяет, должен ли элемент быть отмеченный или не отмеченный
-1 = Возвращает состояние отмеченности
0 = Снимает галочку
1 = (по умолчанию) Устанавливает галочку
$s_mode [необязательный] Режим поиска
byValue = (по умолчанию) по параметру "value" чекбокса
byIndex = по индексу чекбокса, отсчёт от 0
$f_fireEvent [необязательный] specifies whether to fire OnChange and OnClick events after changing value
0 = do not fire OnChange or OnClick event after setting value
1 = (по умолчанию) fire OnChange and OnClick events after setting value

Возвращаемое значение

Успех:Если $f_select = -1, то возвращается текущее состояние чекбокса, иначе возвращается 1
Ошибка:Возвращает 0 и устанавливает @error
@error:0 ($_IEStatus_Success) = Нет ошибок
3 ($_IEStatus_InvalidDataType) = Неверный тип данных
4 ($_IEStatus_InvalidObjectType) = Неверный тип объекта
5 ($_IEStatus_InvalidValue) = Неверное значение
7 ($_IEStatus_NoMatch) = Нет совпадений
@extended:Содержит номер неверного параметра

Примечания

The $f_fireEvent parameter is significant only if the form element has an onChange event associated with it.

$s_Name is optional for this function. If it is omitted, the function will operate on a collection of all <input type=checkbox> elements in the form. If specified, the function will operate on a collection of <input type=checkbox> elements with that name.

См. также

_IEFormElementOptionSelect, _IEFormElementRadioSelect, _IEFormElementGetValue, _IEFormElementSetValue

Пример

#include <IE.au3>

; ====================================
; Пример 1 - Открывает браузер с примером "form", получает ссылки на формы, ставит
;               и снимает галочки в чекбоксах по параметру "byValue". Так как $s_Name не указан, то
;               воздействует со всеми элементами <input type=checkbox> в форме.
;               Примечание: Возможно вам придётся прокрутить страницу вниз, чтобы видеть изменения
$oIE = _IE_Example("form")
$oForm = _IEFormGetObjByName($oIE, "ExampleForm")
For $i = 1 To 5
    _IEFormElementCheckBoxSelect($oForm, "gameBasketball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameFootball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameTennis", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameBaseball", "", 1, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameBasketball", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameFootball", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameTennis", "", 0, "byValue")
    Sleep(1000)
    _IEFormElementCheckBoxSelect($oForm, "gameBaseball", "", 0, "byValue")
    Sleep(1000)
Next

; ====================================
; Пример 2 - Открывает браузер с примером "form", получает ссылки на формы, ставит
;               и снимает галочки в чекбоксах по параметру byIndex. Так как $s_Name не указан, то
;               воздействует со всеми элементами <input type=checkbox> в форме.
;               Примечание: Возможно вам придётся прокрутить страницу вниз, чтобы видеть изменения
$oIE = _IE_Example("form")
$oForm = _IEFormGetObjByName($oIE, "ExampleForm")
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

; ====================================
; Пример 3 - Открывает браузер с примером "form", получает ссылки на формы, ставит и снимает
;               галочки в чекбоксах по параметру byIndex в группе, которая имеют имя checkboxG2Example
;               Примечание: Возможно вам придётся прокрутить страницу вниз, чтобы видеть изменения
$oIE = _IE_Example("form")
$oForm = _IEFormGetObjByName($oIE, "ExampleForm")
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