AIT_CtrlClick
機能
アクティブなウィンドウの特定のコントロールでマウスをクリックします。
形式
bool AIT_CtrlClick ( string strCaption, // コントロールのキャプション integer nCtrlType, // コントロールタイプ integer nMouseButton // マウスボタン [,float fTimeOut] // タイムアウト時間 ); bool AIT_CtrlClick ( integer nCtrlID, // コントロールID integer nCtrlType, // コントロールタイプ integer nMouseButton // マウスボタン [,float fTimeOut] // タイムアウト時間 );
引数
strCaption(入力用)
コントロールのキャプションを指定してください。
nCtrlID(入力用)
コントロールIDを指定してください。
nCtrlType(入力用)
コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。
値 |
意味 |
---|---|
BUTTON_CTRL |
コントロールタイプはコマンドボタンです。 |
CHECKBOX_CTRL |
コントロールタイプはチェックボックスです。 |
OPTIONBUTTON_CTRL |
コントロールタイプはオプションボタンです。 |
EDIT_CTRL |
コントロールタイプはエディットボックスです。 |
STATIC_CTRL |
コントロールタイプはスタティックテキストコントロールです。 |
COMBO_CTRL |
コントロールタイプはコンボボックスです。 |
LISTBOX_CTRL |
コントロールタイプはリストボックスです。 |
SPIN_CTRL |
コントロールタイプはスピンコントロールです。 |
TREE_CTRL |
コントロールタイプはツリーコントロールです。 |
LIST_CTRL |
コントロールタイプはリストコントロールです。 |
DTPICKER_CTRL |
コントロールタイプは日時ピッカーです。 |
nMouseButton(入力用、省略可)
マウスでクリックするボタンを指定してください。次の値のどれかにする必要があります。
値 |
意味 |
---|---|
LBUTTON |
左マウスボタン |
MBUTTON |
中央マウスボタン |
RBUTTON |
右マウスボタン |
省略した場合は、LBUTTONがデフォルト値として使用されます。
fTimeOut(入力用、省略可)
この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。
戻り値
この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。
拡張エラー番号 |
エラーコード |
---|---|
8 |
ERROR_NOT_ENOUGH_MEMORY |
14 |
ERROR_OUTOFMEMORY |
87 |
ERROR_INVALID_PARAMETER |
112 |
ERROR_DISK_FULL |
1400 |
ERROR_INVALID_WINDOW_HANDLE |
1460 |
ERROR_TIMEOUT |
注意事項
コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」(波記号)を付けます。