8.6.3 MessageBox (ダイアログボックスにメッセージを表示する)
- 機能
-
ダイアログボックスにメッセージを表示します。メッセージボックスにはボタンやアイコンの付加を指定できます。ボタンがクリックされるのを待って,どのボタンがクリックされたかを示す値を返します。
- 形式
MessageBox ( Text , 〔Buttons〕 , 〔DefaultBtn〕 , 〔IconStyle〕 , 〔ModalStyle〕 〔, Title〕 )
- 指定項目
-
- Text
-
ダイアログボックス内にメッセージとして表示する文字列を文字列,または値を格納した変数名で指定します。スクリプトファイルの先頭に「#Option = NOCHANGE」の記述がない場合,メッセージの文字列中に含まれる"\r","\n","\t","\\"はそれぞれ対応するコントロールコードとして処理されます。
コントロールコードについては,「6.1.11 コーディング規則」を参照してください。
- Buttons
-
メッセージボックスに付加するボタンの種類と個数を指定します。
この値は次のどれかになります。
値
意味
OK
[OK]ボタンだけを表示します。
OKCancel
[OK]ボタンと[キャンセル]ボタンを表示します。
YesNo
[はい]ボタンと[いいえ]ボタンを表示します。
YesNoCancel
[はい],[いいえ],および[キャンセル]の三つのボタンを表示します。
RetryCancel
[再試行]ボタンと[キャンセル]ボタンを表示します。
AbortRetryIgnoreまたはAbort
[中止],[再試行],および[無視] の三つのボタンを表示します。
この値は省略できます。省略した場合は,[OK]ボタンだけを表示します。
- DefaultBtn
-
Buttonsで指定されたボタンのなかでどのボタンが標準ボタンになるかを指定します。
この値は次のどれかになります。
値
意味
1
第1ボタンを標準ボタンにします。
2
第2ボタンを標準ボタンにします。
3
第3ボタンを標準ボタンにします。
この値は省略できます。省略した場合,1が仮定されます。
- IconStyle
-
メッセージボックスに付加するアイコンのスタイルを指定します。
この値は次のどれかになります。
値
意味
ExclamationまたはEx
感嘆符「!」
InformationまたはInfo
円の中に「i」の字
Question
疑問符「?」
Stop
「STOP」
この値は省略できます。省略した場合,アイコンは表示されません。
- ModalStyle
-
メッセージボックスがモーダルかどうかを指定します。
この値は次のどれかになります。
値
意味
ApplicationModalまたはAppliModal
アプリケーションモーダルに設定します。ほかのアプリケーションのウィンドウに移動して作業することはできます。
SystemModalまたはSysModal
システムモーダルに設定します。ユーザがすぐ気付く必要があるような重大なエラーを通知するために使用します。
この値は省略できます。省略した場合,ApplicationModal が仮定されます。
- Title
-
メッセージボックスのタイトルバーに表示するタイトルを文字列,または値を格納した変数名で指定します。
この値は省略できます。省略した場合,"JP1/Script MessageBox" が表示されます。
- 説明
-
指定されたパラメタでメッセージボックスを表示します。コマンドが正常に実行された場合は真(True)を,エラーが発生した場合は偽(False)を,コマンドの実行結果として返します。
入力されたボタンの値は_MSG_RTN_予約変数に格納されます。格納される値は次のどれかになります。
値
入力されたボタン
OK
[OK]
CANCEL
[キャンセル]
ABORT
[中止]
RETRY
[再試行]
IGNORE
[無視]
YES
[はい]
NO
[いいえ]
[キャンセル]ボタンが表示されているダイアログボックスでは,Escキーを押すと,[キャンセル]ボタンをクリックしたときと同じ結果になります。
- 補足
-
スクリプトをサービスで起動する場合は,このコマンドは使用できません。使用すると実行エラーになります。
- 例
MessageBox ( "終了してもいいですか?" ,OKCancel , ,Question ) If _MSG_RTN_ <>CANCEL Then Exit End
表示例
- 対象バージョン
-
JP1/Script 01-00以降