XMESSAGE
Section: User Commands (1)
Updated: Release 6.6
索引
xjman
名前
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
Index
- 名前
-
- 書式
-
- 説明
-
- オプション
-
- ウィジェットの階層構造
-
- リソース
-
- アクション
-
- 終了ステータス
-
- 関連項目
-
- 著者
-
Time: 07:00:45 GMT, January 12, 2009