AIT_SelectMultipleListItem
機能
アクティブなウィンドウの特定の複数選択コントロールで指定した項目を選択します。
形式
bool AIT_SelectMultipleListItem ( string strCaption, // コントロールのキャプション integer nCtrlType, // コントロールタイプ string strItemText // 選択される項目テキスト [,float fTimeOut] // タイムアウト時間 ); bool AIT_SelectMultipleListItem ( integer nCtrlID, // コントロールID integer nCtrlType, // コントロールタイプ string strItemText // 選択される項目テキスト [,float fTimeOut] // タイムアウト時間 );
引数
strCaption（入力用）
コントロールのキャプションを指定してください。
nCtrlID（入力用）
コントロールIDを指定してください。
nCtrlType（入力用）
コントロールタイプを指定してください。次の値のどれかに該当する必要があります。
|
値 |
意味 |
|---|---|
|
LISTBOX_CTRL |
コントロールタイプはリストボックスです。 |
|
LIST_CTRL |
コントロールタイプはリストコントロールです。 |
strItemText（入力用）
特定の複数選択コントロールで選択するテキストを指定してください。複数指定する場合はコンマで区切った値で指定できます。
fTimeOut（入力用、省略可）
この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の設定値が使用されます。
戻り値
関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。
関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。
|
拡張エラー番号 |
エラーコード |
|---|---|
|
6 |
ERROR_INVALID_HANDLE |
|
8 |
ERROR_NOT_ENOUGH_MEMORY |
|
14 |
ERROR_OUTOFMEMORY |
|
87 |
ERROR_INVALID_PARAMETER |
|
112 |
ERROR_DISK_FULL |
|
1400 |
ERROR_INVALID_WINDOW_HANDLE |
|
1460 |
ERROR_TIMEOUT |
注意事項
-
AIT_SelectMultipleListItem関数は複数選択できるコントロールだけで使用してください。
-
コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。