XMESSAGE(1)

名前
xmessage - ウィンドウにメッセージや問い合わせを表示する(X 版の /bin/echo)

書式
xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] -file filename
xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] message ...

説明
xmessage プログラムはコマンドライン、ファイル、標準入力から入力したメッセージを ウィンドウに表示する。 メッセージの下辺に沿ってボタンの行が配置される。これらのボタンの上でマ ウスの左ボタンを押すと、xmessage は終了する。 どのボタンが押されたのかは終了ステータスとして返される。また、オプショ ン指定によっては、ボタンのラベルが標準出力に書き出される。

このプログラムは普通、シェルスクリプトにおいてユーザに情報を表示するた めやユーザに選択をさせるために用いられる。

サイズを指定しなければ、xmessage はメッセージに合わせて自動的に サイズ(最大サイズ以下)を決める。 メッセージがウィンドウに対して大きすぎる場合、xmessage はスクロー ルバーを表示する。

オプション
xmessage が認識するコマンドラインオプションを示す。

-buttons button,button,...
    このオプションを指定すると、xmessage はコンマで区切られた button 引き数のそれぞれの値に対して、1つずつボタンを生成する。 このオプションに対応するリソースは buttons である。 button のそれぞれの値はラベルであり、オプションとしてコロンと終 了ステータス値を続けることができる。 ラベルは生成される Command button ウィジェットの名前であり、ユーザに対 して表示されるデフォルトのテキストとなる。これはウィジェットの名前なの で、これを使ってボタンに対応するリソースを変更することができる。 終了ステータス値は、ボタンが押されたときに xmessage が返す値であ る。デフォルトの終了ステータス値は (100 + ボタン番号) である。ボタン番 号には、1から始まる番号が左から順に付けられる。 -buttons オプションを指定されていない場合に使われる、デフォルト の文字列は okay:0 である。

-default label
    label にマッチするボタンをデフォルトのボタンとして定義する。 これを指定しなければ、デフォルトのボタンは定義されない。 このオプションに対応するリソースは defaultButton である。 xmessage のウィンドウ内の任意の場所でリターンキーが押されると、 デフォルトのボタンがアクティブにされる。 デフォルトのボタンは他のボタンよりも広い境界を持つ。

-file filename
    表示するファイルを指定する。 このオプションに対応するリソースはfileである。 filename に `-' を指定すると、標準入力から読み込みが行わ れる。 このオプションを指定しなければ、xmessage は echo と同じよ うに、オプションでない全ての引き数を表示する。 -file オプションとコマンドラインからのメッセージのいずれかのみ を指定すべきであり、両方から指定してはならない。

-print
    このオプションを指定すると、プログラムは押されたボタンのラベルを標準出 力に出力する。この指定は、printValue リソースに TRUE をセットす ることと同じ意味である。

-center
    スクリーンの中央にウィンドウを出す。 この指定は、center リソースに TRUE をセットすることと同じ意味で ある。

-nearmouse
    マウスカーソルの近くにウィンドウを出す。 この指定は、nearMouse リソースに TRUE をセットすることと同じ意味 である。

-timeout secs
    ユーザがボタンを押さなければ、xmessage は secs 秒間待って からステータス0で終了する。 この指定は、timeout リソースによる指定と同じ意味である。 各ウィジェットの名前と階層における位置を知っておくと、リソースを指定す る際に便利である。各ウィジェットのクラスと名前を以下の図に示す。

Xmessage (xmessage)
	Form form
		Text message
		Command (label1)
		Command (label2)
		.
		.
		.

リソース
xmessage にはいくつかのトップレベルアプリケーションリソースがあ り、これを使ってアプリケーション固有の設定を行うことができる。

file
    内容を表示するファイルを指定する文字列。

buttons
    表示するボタンを指定する文字列。 -buttons コマンドラインオプションを参照すること。

defaultButton
    ラベルを使ってデフォルトボタンを指定する文字列。

printValue
    プログラムを終了させるボタンが押されたときに、そのラベルを標準出力に書 き出すかどうか指定する真偽値。 デフォルト値は FALSE である。

center
    ウィンドウをスクリーンの中央に出すかどうか指定する真偽値。デフォルト値 は FALSE である。

nearMouse
    ウィンドウをマウスカーソルの近くに出すかどうか指定する真偽値。デフォル ト値は FALSE である。

timeout
    プログラムがステータス0で終了するまでの秒数。デフォルト値は0であり、こ の場合には決してタイムアウトしない。

maxHeight (class Maximum)
    ウィンドウのテキスト部分の最大の高さをピクセル数で指定する。これはジオ メトリでサイズが指定されなかったときに使われる。 デフォルト値は0であり、この場合にはスクリーンの高さの70%が使われる。

maxWidth (class Maximum)
    ウィンドウのテキスト部分の最大の幅をピクセル数で指定する。これはジオメ トリでサイズが指定されなかったときに使われる。 デフォルト値は0であり、この場合にはスクリーンの幅の70%が使われる。

アクション

exit(value)
    終了ステータスvalue(デフォルト値は0)で即座に終了する。このアクショ ンは、xmessage が終了する別の方法を与えるために、トランスレーショ ンと共に用いられる。

default-exit()
    デフォルトボタンで指定された終了ステータスで即座に終了する。 デフォルトボタンがない場合、このアクションは何もしない。

終了ステータス
エラーが起こった場合には xmessage は 1 を返す。従って、この値を ボタンに割り当ててはならない。

関連項目
X(1), echo(1), cat(1)

著者
Chris Peterson, MIT Project Athena
Stephen Gildea, X Consortium