LOTUSSCRIPT 言語

MessageBox 関数とステートメント
例

メッセージボックスにメッセージを表示して、ユーザーの確認を待ちます。関数の構文ではユーザーがクリックしたボタンに対応した値を返します。

関数の構文MessageBox ( message [ , [ buttons + icon + default + mode ] [ , boxTitle ] ] )
ステートメントの構文MessageBox message [ , [ buttons + icon + default + mode ] [ , boxTitle ] ]
MessageBox 関数と MessageBox ステートメントは同じですが、値を返すのは関数だけです。

MessageBox の代わりに MsgBox と省略できます。

構成要素message


buttons icon default mode boxTitle
戻り値MessageBox 関数の戻り値は、1 以上 7 以下の整数です。この値は、ユーザーがメッセージボックスのどのボタンをクリックしたかを示します。次の表に値を示します。
戻り値ボタン定数
1[OK]IDOK
2[キャンセル]IDCANCEL
3[中止]IDABORT
4[再試行]IDRETRY
5[無視]IDIGNORE
6はいIDYES
7[いいえ]IDNO

使用法上記の表に示した要素 buttons、icon、default、mode に有効な値は、LSCONST.LSS ファイル内で定数として定義されています。数値の代わりに定数を使う場合は、このファイルをスクリプトに取り込みます。
LotusScript を使用できる Lotus ソフトウェアには、message と boxTitle に上記の表に示したよりも長い文字列を指定できるものがあります。Lotus ソフトウェアでサポートされていれば、LotusScript もこれらの項目に対してより長い文字列をサポートします。

メモ message の長さはオペレーティングシステムに依存します。混合環境 (PC と Mac など) でアプリケーションを起動する場合は、message 長を、使用するオペレーティングシステムの最小限度と同じかそれより小さくしてください。

message 要素内で強制的に改行するには、改行文字を使用します。または、縦線やカッコを使って複数行の文字列を指定します。強制的に改行しないと、テキストはメッセージボックスの中で自動的に折り返されます。

メモ 改行は、すべてのプラットフォームで chr(10) または chr(13) を意味するわけではありません。改行は、行の終端を示すために使われる文字または文字列です。この文字は、Chr(10) や Chr(13) の場合もあれば、それ以外の場合もあります。これは、改行の実際の値がプラットフォームに依存するためです。出力に改行が必要な場合、プログラマはプラットフォームに適した改行が文字列に含まれるようにする必要があります。

Lotus Notes から LotusScript を使っている場合、MessageBox 関数は次のように動作します。

メモ MessageBox 関数がバックエンドで実行されている場合は、既定設定やモードに関係なく、常にゼロが返されます。この場合、プロンプトのみが表示されます。サーバーでは、サーバーコンソール、Lotus Notes ログ、およびデバッグ出力のリダイレクト先 (DEBUG_OUTFILE) に表示が切り替わり、クライアントではデバッグコンソールに表示が切り替わります。MessageBox ステートメントの場合は、この処理が行われません。

例
関連項目