Manpages

名 前

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 オ プ シ ョ ン と コ マ ン ド 行 か ら の メ ッ セ ー ジ の い ず れ か の み を 指 定 す べ き で あ り 、 両 方 か ら 指 定 し て は な ら な い 。

printValue リ ソ ー ス に TRUE を セ ッ ト す る こ と と 同 じ 意 味 で あ る 。

ス に TRUE を セ ッ ト す る こ と と 同 じ 意 味 で あ る 。

−nearmouse マ ウ ス カ ー ソ ル の 近 く に ウ ィ ン ド ウ を 出 す 。 こ の 指 定 は 、 nearMouse リ ソ ー ス に TRUE を セ ッ ト す る こ と と 同 じ 意 味 で あ る 。
−timeout secs ユ ー ザ が ボ タ ン を 押 さ な け れ ば 、 xmessage は secs 秒 間 待 っ て か ら ス テ ー タ ス 0で 終 了 す る 。 こ の 指 定 は 、 timeout リ ソ ー ス に よ る 指 定 と 同 じ 意 味 で あ る 。

ウ ィ ジ ェ ッ ト の 階 層 構 造

各 ウ ィ ジ ェ ッ ト の 名 前 と 階 層 に お け る 位 置 を 知 っ て お く と 、 リ ソ ー ス を 指 定 す る 際 に 便 利 で あ る 。 各 ウ ィ ジ ェ ッ ト の ク ラ ス と 名 前 を 以 下 の 図 に 示 す 。

Xmessage (xmessage)

リ ソ ー ス

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

−buttons コ マ ン ド 行 オ プ シ ョ ン を 参 照 す る こ と 。
defaultButton ラ ベ ル を 使 っ て デ フ ォ ル ト ボ タ ン を 指 定 す る 文 字 列 。
printValue プ ロ グ ラ ム を 終 了 さ せ る ボ タ ン が 押 さ れ た と き に 、 そ の ラ ベ ル を 標 準 出 力 に 書 き 出 す か ど う か 指 定 す る 真 偽 値 。 デ フ ォ ル ト 値 は FALSE で あ る 。

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

あ り 、 こ の 場 合 に は 決 し て タ イ ム ア ウ ト し な い 。

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