MessageBox

ユーザ定義のテキスト文字列を含んでいる「ポップアップ」メッセージボックスを表示します。

注 : メッセージボックスコントロールのプロパティシートにアクセスするには、コントロールを右クリックして [関数] を選択します。

MessageBoxの入力パラメータ

Syntax:MessageBox(タイトル,テキスト,ステータス,タイムアウト,ボタンラベル)

タイトル

メッセージボックスのタイトルバーに表示される名前

テキスト

表示するテキストメッセージ

ステータス

メッセージボックスを表示する条件式または値を含んでいるセルへの参照。参照されたセル内の値が 0 と評価されている間は、メッセージボックスは表示されません。参照されたセル内の値がゼロ以外の値である場合は常に、メッセージボックスが表示されます。

タイムアウト

ユーザ入力が受け取られなかった場合、メッセージボックスが閉じられるまでに、メッセージボックスが待機する時間の合計 (-1 ～ 9999999 ms、デフォルト = 5000)。[タイムアウト] を 0 または -1 に設定した場合、メッセージボックスは、ユーザ入力が受け取られるまで無期限に表示されます。

ボタンラベル

メッセージボックスの下部に表示するユーザ入力ボタンのタイプを指定します。ボタンを押すと、メッセージボックスは表示されなくなり、関数が値を返します。返される値は押されたボタンによって異なります。

0 = はい、いいえ (デフォルト)	[はい] をクリックすると、1.000 の値が返されます。[いいえ] をクリックすると、0.000 の値が返されます。
1 = OK、キャンセル	[OK] をクリックすると、1.000 の値が返されます。[キャンセル] をクリックすると、0.000 の値が返されます。
2 = クローズ	[クローズ] をクリックすると、1.000 の値が返されます。

MessageBoxの出力

戻り値	ユーザがボタンをクリックした場合は 0.000 または 1.000 の値、指定された [タイムアウト] 時間に達した場合は -1.000。入力パラメータが無効であれば #ERR を返します。

MessageBox例

スプレッドシートが次のように設定されています。

A2=MessageBox("警告!","これはメッセージボックスの例です。",B2,5000,1)
B2=CheckBox("テスト")

セル B2 内のチェックボックスをオンにすると、セル A2 に定義されているメッセージボックスが自動的に表示されます。

[OK] をクリックすると、セル A2.に 1.000 の値が返されます。[キャンセル] をクリックすると、セル A2 に 0.000 の値が返されます。ユーザ入力が受け取られる前に 5000 ミリ秒の [タイムアウト] に達した場合は、セル A2 に -1.000 の値が返されます。