函数参考


_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的表单对象变量
$s_string 用于匹配元素的值 - 基于$s_mode
$s_name [可选参数]: 复选框名称或编号(es)
$f_select [可选参数]: 指定元素选中或未选中
-1 = 返回选中状态
0 = 不选元素
1 = (默认)选中元素
$s_mode [可选参数]: 指定搜索模式
按值 = (默认)要选取的复选框的值
按索引 = 要选取的复选框的0基索引
$f_fireEvent [可选参数]: 指定是否在改变值后激活OnChange和OnClick事件
0 = 设置值后不激活OnChange或OnClick事件
1 = (默认)设置值后激活OnChange或OnClick事件

返回值

成功: 如果$f_select = -1, 返回当前的被选中状态, 或返回1
失败: 返回 0 并且设置 @ERROR
@Error: 0 ($_IEStatus_Success) = 无错误
1 ($_IEStatus_GeneralError) = 一般性错误
3 ($_IEStatus_InvalidDataType) = 无效数据类型
4 ($_IEStatus_InvalidObjectType) = 无效对象类型
5 ($_IEStatus_InvalidValue) = 无效值
7 ($_IEStatus_NoMatch) = 无匹配
@Extended: 包含无效参数数量

注意/说明

仅当表单元素与onChange事件关联时, $f_fireEvent参数才有效.

$s_Name对该函数是可选的. 如果忽略, 函数将操作表单中所有元素的集合. 如果指定, 函数具有该名称的元素的集合.

相关

_IEFormElementOptionSelect, _IEFormElementRadioSelect, _IEFormElementGetValue, _IEFormElementSetValue

示例/演示


; *******************************************************
; 示例1 - 打开带有表单示例的浏览器, 获取表单的引用.
;               通过值选定或不选定复选框. 由于未指定$s_Name,
;               对表单中所有的<input type=checkbox>元素集合进行操作
;               注意: 为查看变化你可能需要向下滚动页面
; *******************************************************

#include <IE.au3>

Local $oIE = _IE_Example("form")
Local $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 - 打开带有表单示例的浏览器, 获取表单的引用.
;               通过索引选定或不选定复选框. 由于未指定$s_Name
;               对表单中所有的<input type=checkbox>元素集合进行操作
;               注意: 为查看变化你可能需要向下滚动页面
; *******************************************************

#include <IE.au3>

$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 - 打开带有表单示例的浏览器, 获取表单的引用.
;               通过checkboxG2Example组中的索引选定或不选定复选框.
;               注意: 为查看变化你可能需要向下滚动页面
; *******************************************************

#include <IE.au3>

$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