AIT_MessageBox
機能
指定したメッセージをダイアログボックスに表示し、ユーザがどれかのボタンをクリックするまで待機し、ユーザが選択したボタンを示す値を返します。
形式
integer AIT_MessageBox ( string strMessage, // メッセージ string strTitle // タイトル [,integer nIconType] // アイコンタイプ [,integer nMsgBoxType] // メッセージボックスタイプ );
引数
strMessage(入力用)
メッセージボックスに表示するメッセージを指定してください。
strTitle(入力用)
メッセージボックスのタイトルを指定してください。
nIconType(入力用、省略可)
表示するアイコンタイプを指定してください。次の値のどれかに該当する必要があります。
値 |
意味 |
---|---|
MB_ICONEXCLAMATION |
メッセージボックスに「!」(感嘆符)のアイコンが表示されます。 |
MB_ICONINFORMATION |
メッセージボックスに、丸の中に「i」があるアイコンが表示されます。 |
MB_ICONQUESTION |
メッセージボックスに「?」(疑問符)のアイコンが表示されます。 |
MB_ICONSTOP |
メッセージボックスに停止標識のアイコンが表示されます。 |
省略した場合は、MB_ICONEXCLAMATIONがアイコンタイプになります。
nMsgBoxType(入力用、省略可)
メッセージボックスタイプを指定してください。次の値のどれかに該当する必要があります。
値 |
意味 |
---|---|
MB_ABORTRETRYIGNORE |
[中止]、[再試行]、および[無視]ボタンがあるメッセージボックス |
MB_OK |
[OK]ボタンだけがあるメッセージボックス |
MB_OKCANCEL |
[OK]および[キャンセル]ボタンがあるメッセージボックス |
MB_RETRYCANCEL |
[再試行]および[キャンセル]ボタンがあるメッセージボックス |
MB_YESNO |
[はい]および[いいえ]ボタンがあるメッセージボックス |
MB_YESNOCANCEL |
[はい]、[いいえ]、および[キャンセル]ボタンがあるメッセージボックス |
省略した場合は、MB_OKがメッセージボックスタイプに指定されます。
戻り値
ユーザが選択したボタンを表す値を返します。次のどれかの値になります。
値 |
意味 |
---|---|
IDABORT |
[中止]ボタンが選択されました。 |
IDCANCEL |
[キャンセル]ボタンが選択されました。 |
IDIGNORE |
[無視]ボタンが選択されました。 |
IDNO |
[いいえ]ボタンが選択されました。 |
IDOK |
[OK]ボタンが選択されました。 |
IDRETRY |
[再試行]ボタンが選択されました。 |
IDYES |
[はい]ボタンが選択されました。 |
上記以外の値が返った場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。
拡張エラー番号 |
エラーコード |
---|---|
87 |
ERROR_INVALID_PARAMETER |