.TH DIALOG 1 "10 January 1994"
.\" jpman %Id: dialog.1,v 1.3 1997/07/27 11:54:02 horikawa Stab %
.SH 名称
dialog \- シェルスクリプトからダイアログボックスを表示する
.SH 書式
.B dialog --clear
.br
.BI "dialog --create-rc " file
.br
.B dialog
[
.BI "\-\-title " title
]
[
.B \-\-clear
]
[
.BI "\-\-hline " line
]
[
.BI "\-\-hfile " file
]
.B box-options
.SH 解説
.B dialog
はシェルスクリプトから、
質問形式、メッセージ表示形式など、
いろいろな種類のダイアログボックスを表示するプログラムです。
現在サポートされているイアログボックスは
以下のとおりです。
.LP
.BR yes/no " ボックス、" " menu" " ボックス、" " input" " ボックス、"
.BR message " ボックス、" " text" " ボックス、" " info" " ボックス、"
.BR checklist " ボックス、" " program" " ボックス"
.SH オプション
.TP
.B \-\-clear
終了時に画面をクリアします。
.TP
.BI \-\-create-rc " file"
.B dialog
はランタイムコンフィグレーションをサポートしています。
.I file
にサンプルの設定ファイルを書き出します。
.TP
.BI \-\-title " title"
ダイアログボックスの最上行に表示する文字列
.I title
を指定します。
.TP
.BI \-\-hline " line"
ダイアログボックスの最下行に表示する文字列
.I line
を指定します。
.TP
.BI \-\-hfile " file"
? キーか F1 キーをタイプしたときに
表示する
.I file
を指定します。
.TP
.B ボックスオプション
.TP
.BI \-\-yesno " text height width"
縦
.I height
横
.I width
のサイズの
.BR yes/no
ダイアログボックスを表示します。
.I text
で指定された文字列はダイアログボックスの内部に
表示されます。
この文字列が長すぎて、1行で表示できない場合は、
自動的に複数行に分割されます。
.I text
が文字列
.I
"\en"
もしくは改行文字
.I `\en\'
を含んでいる場合、その場所で
改行します。
このダイアログボックスは
ユーザに yes あるいは no という返答を求める
際に役に立ちます。
ダイアログボックスは
.B Yes
と
.B No
のボタンを持っており、
.IR TAB
キーで選択することができます。
.TP
.BI \-\-msgbox " text height width"
.B message
ボックスは
.B yes/no
ボックスと似ていますが、
.B message
ボックスの場合、
.B OK
ボタンしか表示されません。
このダイアログボックスを使って、メッセージを表示
することができます。
ユーザはこのメッセージを読んだ後、
.I ENTER
キーを押して、
.B dialog
を終了し、シェルスクリプトの実行を続けることになります。
.TP
.BI \-\-infobox " text height width"
.B info
ボックスは基本的に
.B message
ボックスと同じですが、メッセージを表示すると
すぐに終了します。
.B dialog
の終了時に画面はクリアされません。
メッセージはシェルが後で画面をクリアするまで残ります。
これは終了までに時間のかかる処理を行うことを、
ユーザに知らせるときに便利です。
.TP
.BI \-\-inputbox " text height width"
.B input
ボックスはユーザに文字列を入力させる
ときに役に立ちます。入力時に
.I バックスペース
キーを
押すことで、タイプミスを訂正することができます。
入力文字列がダイアログボックスより長くなった
場合は、入力フィールドがスクロールします。
終了時には入力された文字列を
.IR stderr
に出力します。
.TP
.BI \-\-textbox " file height width"
.B text
ボックスは、テキストファイルの内容をダイアログボックスの中に
表示するためのものです。これは簡単なテキストファイルビュアーの
ようなものです。
表示中は、
.IR UP/DOWN "、" PGUP/PGDN "、" HOME/END
キーを使ってファイル中を移動できます。
1 行がダイアログボックスより長い場合は、
.I LEFT/RIGHT
で左右にスクロールできます。
より便利に使うために、
前方検索、後方検索の機能も実装されています。
.IP "\fB\-\-menu \fItext height width menu-height \fR[ \fItag item \fR] \fI..."
.B menu
ボックスは、その名のとおりダイアログボックスにリストを表示して
ユーザに選ばせるものです。
各メニューは
.I tag
と
.I item
で構成されます。
.I tag
は他の項目と区別するためのものです。
.I item
はその項目が表す内容を短く記述したものです。
ユーザは
.I UP/DOWN
キー、または
.I tag
の先頭文字、
.I 1-9
を押すことで項目を選べます。
.I menu-height
は一度に表示できるメニューの数を設定します。
.I menu-height
より多くの項目がある場合、メニューがスクロールします。
.B dialog
を終了するとき、
選択されたメニューの
.I tag
が
.I stderr
に出力されます。
.TP
.BI \-\-prgbox " command height width"
.B program
ボックスは
.B command
の出力をダイアログボックスに表示します。
.IP "\fB\-\-checklist \fItext height width list-height \fR[ \fItag item status \fR] \fI..."
.B checklist
ボックスは、
メニューから項目を選ぶという点で
.B menu
ボックスと似ていまが、
項目のなかから 1 つを選ぶのではなく、
ユーザが各項目をオン・オフに設定することができます。
各項目のオン・オフの初期設定は
.I status
で設定できます。
終了時には、
ステータスがオンになっている項目の
.I tag
が
.I stderr
に出力されます。
.SH ランタイムコンフィグレーション
.TP 4
1.
以下のように、サンプルの設定ファイルを作成します。
.LP
.in +1i
"dialog --create-rc <file>"
.TP 4
2.
.B dialog
は以下のように読み込む設定ファイル決定します。
.RS
.TP 4
a)
環境変数
.B DIALOGRC
が設定されている場合、その値は設定ファイル名として扱われます。
.TP 4
b)
(a) で指定されたファイルが存在しなかった場合、
.I $HOME/.dialogrc
が設定ファイルとして扱われます。
.TP 4
c)
(b) のファイルが存在しなかった場合、
デフォルトの設定で起動します。
.RE
.TP 4
3.
サンプルの設定ファイルを編集して、
2 を参考に
.B dialog
が見付けることができる場所にコピーします。
.SH 環境変数
.TP 15
.B DIALOGRC
独自に設定をする場合は、設定ファイル名を指定します。
.SH 関連ファイル
.TP 20
.I $HOME/.dialogrc
デフォルトの設定ファイル
.SH 診断
.BR dialog
が
.BR Yes
か
.BR OK
を押されて終了した場合は 0 を、
.BR No
か
.BR Cancel
を押されて終了した場合は 1 を返します。
また、
.B dialog
の内部でエラーが起こるか、
.B dialog
を
.I ESC
キーを押して終了させた場合、-1 を返します。
.SH 関連項目
.B dialog(3)

.SH バグ
.I タブ
キャラクタを含むテキストファイルを
.B text
ボックス
で表示すると、うまく表示されません。
テキストファイルの中の
.I タブ
キャラクタは
事前にスペースに変換しておかなくてはなりません。
.TP
画面の書き換えには時間がかかります。
.SH 作者
Savio Lam (lam836@cs.cuhk.hk)