名 前
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 を 返 す 。 従 っ て 、 こ の 値 を ボ タ ン に 割 り 当 て て は な ら な い 。
関 連 項 目
著 者
Chris Peterson,
MIT Project Athena
Stephen Gildea, X Consortium