指定されたフォーム要素の値を設定します。
#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 | [オプション]チェックボックスの名前またはID |
| $f_select | [オプション]要素のチェック/非チェックを指定します -1 = チェック状態を返します 0 = 要素のチェックをはずします 1 = (デフォルト) 要素をチェックします |
| $s_mode | [オプション]検索モードを指定します byValue = (デフォルト) 選択したいチェックボックスの値 byIndex = 選択したいチェックボックスの0始まりのインデックス |
| $f_fireEvent | [オプション]値設定後に変更(OnChange)、クリック(OnClick)のイベント発行をおこなうかどうかを指定します 0 = 値設定後、OnChange、OnClickイベントの発行をおこないません 1 = (デフォルト) 値設定後、OnChange、OnClickイベントの発行をおこないます |
返し値
| 成功: | $f_select = -1の場合、現在のチェック状態を返します。それ以外の場合、1を返します。 |
| 失敗: | 0を返し@ERRORを設定します |
| @Error: | 0 ($_IEStatus_Success) = 正常終了 |
| 3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
| 4 ($_IEStatus_InvalidObjectType) = 無効なオブジェクト型 | |
| 5 ($_IEStatus_InvalidValue) = 無効な値 | |
| 7 ($_IEStatus_NoMatch) = 一致するものがありません | |
| @Extended: | 無効なパラメータの番号が格納されています |
注意
$f_fireEventパラメータはフォーム要素が関連するonChangeイベントを持っている場合のみ重要です。
関連
_IEFormElementOptionSelect, _IEFormElementRadioSelect, _IEFormElementGetValue, _IEFormElementSetValue
例
; *******************************************************
; 例 1 - フォームのサンプルをブラウザで開き、フォームの参照を取得
; 値をつかってチェック/非チェックをおこなう。
; $s_Nameを指定していないのでフォームの全<input type=checkbox>要素を操作。
; ノート：変更を確認するにはページをスクロールダウンする必要があるかもしれない
; *******************************************************
;
#include <IE.au3>
$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 - フォームのサンプルをブラウザで開き、フォームの参照を取得
; インデックスをつかってチェック/非チェックをおこなう
; $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