AIT_SetCheck

機能

アクティブなウィンドウの特定のコントロールをオン,オフおよび,不確定状態にします。

形式

bool AIT_SetCheck  (
 string strCaption,     // コントロールのキャプション
 integer nCtrlType      // コントロールタイプ
 [,integer nCondition]  // チェックタイプ
 [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetCheck  (
 integer nCtrlID,       // コントロールID
 integer nCtrlType      // コントロールタイプ
 [,integer nCondition]  // チェック状態のタイプ
 [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption(入力用)

コントロールのキャプションを指定してください。

nCtrlID(入力用)

コントロールのIDを指定してください。

nCtrlType(入力用)

コントロールタイプを指定してください。これは,次の値のどれかにする必要があります。

意味
CHECKBOX_CTRLコントロールタイプがチェックボックスです。
OPTIONBUTTON_CTRLコントロールタイプがオプションボタンです。

nCondition(入力用,省略可)

チェック状態のタイプを指定してください。これは,次の値のどれかにする必要があります。

意味
0オフにした状態
1オンにした状態
2不確定またはグレー表示された状態

fTimeOut(入力用,省略可)

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は,関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue,そのほかの場合はfalseになります。関数がfalseを返した場合には,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。

拡張エラー番号エラーコード
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
87ERROR_INVALID_PARAMETER
112ERROR_DISK_FULL
1400ERROR_INVALID_WINDOW_HANDLE
1460ERROR_TIMEOUT

注意事項

コントロールは,完全なキャプションまたは関連するラベル名を使用するか,キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は,文字列の最初に「~」(波記号)を付けます。