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以降

ページの先頭へ