# gdialogマニュアル

2001
Patanjali Somayaji
2002, 2003
John Fleck
2003
鎌ヶ迫正俊 (日本語訳)
GNOMEドキュメンテーションプロジェクト

&legal;

これはgdialog第2.0版のマニュアルです。

## フィードバック情報

このアプリケーションもしくはドキュメントに関するバグレポートや 提案をするには GNOMEフィードバックページ を参照してください。

Patanjali
Somayaji
GNOMEドキュメンテーションプロジェクト
John
Fleck
GNOMEドキュメンテーションプロジェクト
Masatoshi
KAMAGASAKO
日本GNOMEユーザ会 翻訳チーム

    emerald@gnome.gr.jp

日本語訳
1.0
2001年8月25日

Patanjali Somayaji

GNOMEドキュメンテーションプロジェクト

2.0
2002年4月7日

John Fleck jfleck@inkstain.net

GNOMEドキュメンテーションプロジェクト

GNOME 2版

2.2
2003年1月14日

John Fleck jfleck@inkstain.net

GNOMEドキュメンテーションプロジェクト

GNOME 2版

## はじめに

&app;はコマンドラインまたはシェルスクリプトからGNOMEダイアログを 表示します。

&app;は`gnome-utils`パッケージに含まれていま す。これはGNOMEデスクトップ環境の一部です。このドキュメントは gdialogの第&version;版について説明し ています。

(訳者注) 以下、入出力のエンコーディングには UTF-8 を利用しています。

## gdialogを使う

### 基本的な使い方

`gdialog`コントロールダイアログを生成するため には、一続きのコマンドラインオプションを後に付加して起動します。 例えば、

                gdialog --msgbox "テストメッセージ" 200 150

というコマンドでは、で示され るようなダイアログを生成し表示します。 `--msgbox`オプションは、生成されるダイアログ のタイプを示します。`"テストメッセージ"`は表 示されるメッセージです。続く数字はダイアログの幅と高さを指定し ています。

#### gdialogの例

gdialogメッセージボックスの例

コマンドラインオプションの完全なリストを以下に示します:

`gdialog [--title タイトル] [--separate-output] [--backtitle バックタイトル] [--clear] ボックスオプション`

`タイトル`はダイアログのタイトルを指定します。

"ボックスオプション" は以下のいずれか一つを指定できます。

- `[--defaultno] --yesno テキスト 高さ 幅`

- `--msgbox テキスト 高さ 幅`

- `--infobox テキスト 高さ 幅`

- `--inputbox テキスト 高さ 幅 [初期文字列]`

- `--textbox ファイル 高さ 幅`

- `--menu テキスト 高さ 幅 メニューの高さ タグ1 項目1 ...`

- `--checklist テキスト 高さ 幅 リストの高さ タグ1 項目1 ステータス1 ...`

- `--radiolist テキスト 高さ 幅 リストの高さ タグ1 項目1 ステータス1 ...`

- `--gauge テキスト 高さ 幅 パーセンテージ`

現時点での&app;の実装では、高さと 幅は指定しなければなりません。し かし、これらの値は何の効果も示しません。これは既知のバグです。

## 様々なダイアログボックスを利用する

### 確認ダイアログ — はい/いいえ ボックス

質問と"はい" "いいえ"ボタンを表示するダイアログボックスを生成 するには、`--yesno`オプションを利用します。" マイ ダイアログ"のようなタイトルを付け、"終了しますか?" という 質問の表示されたダイアログボックスを生成するには以下のコマンド を実行します:

                gdialog --title "My Dialog" --yesno "Should I exit ?" 250 150

上のコマンドを実行すると、のよ うなダイアログボックスが表示されます。 .

#### 確認ボックスの例

gdialog確認ボックスの例

次のスクリプトを実行すると、"はい/いいえ" ダイアログを表示し、 入力値に応じたレスポンスを返します:

              #!/bin/sh
              if gdialog --title "はい/いいえ テスト" --yesno "はい/いいえ テスト" 300 300
              then echo "はい をクリックしました。"
              else echo "いいえ をクリックしました。"
              fi

ダイアログが表示された時点では "はい" ボタンがハイライトされて います。デフォルトで"いいえ"にハイライトを当てるには、次のよう に`--defaultno`オプションを加えます:

              gdialog --title "テスト" --yesno "テスト" 1 1 --defaultno

### メッセージボックス

`--msgbox`オプションを付けると、メッセージを 表示したダイアログボックスを生成します:

                gdialog --title "マイ ダイアログ" --msgbox "これがメッセージです" 250 150

このコマンドでに示されるダイ アログボックスが表示されます。

#### メッセージボックスの例

gdialogメッセージボックスの例

### 情報ボックス

`--infobox`オプションで生成されるダイアログボッ クスは`--msgbox`と同等のものですが、閉じる前 に一時的にスクリーン上に表示されるだけです。

### テキストを入力する — 入力ボックス

`--inputbox`オプションを指定すると、テキスト 入力ボックスが表示されます。次のスクリプトで入力したテキストを 表示させることができます。キャンセルボ タンがクリックされるとエラーを返します:

              #!/bin/sh

              if gdialog --title "入力ボックス" \
                         --inputbox "メッセージを受け付けます" 20 20
              then echo $?
              else echo "何も入力されませんでした。"
              fi

### テキストボックス

&app;は`--textbox`を使うことでテキストファイ ルをウィンドウに表示することができます:

              gdialog --title "テキストボックス" --textbox "gdialog.xml" 30 50

ファイルを無事表示できると、&app;はシェルスクリプトに `TRUE`値を返します。ファイルが存在しない場 合、&app;はエラーダイアログを表示して、シェルスクリプトに`FALSE`値を返します。

### メニュー

`--menu`オプションでメニューを生成し、ユーザが選択した値を取得することができます。それぞれのメニューオプションには二つの値があり、一つは`タグ`、もう一つは`項目`です。次のスクリプトで示されるように、&app;は選択された`タグ`の値を返します:

              #!/bin/sh

              if gdialog --title "A Menu" \
                         --menu "メニューのオプションです" 100 200 1 \
                         "One" "一番目の項目" \
                         "Two" "二番目の項目" \
                         "Three" "三番目の項目" \
                         "Four" "四番目の項目" \
                         "Five" "五番目の項目"
              then echo $?
              else echo "何も選択されていません"
              fi

メニュー項目が選択されると、&app;は`TRUE`値 を返します。キャンセルボタンがクリック されると`FALSE`値が返されます。

FIXME - the height and width bits seem to do nothing here

### チェックリスト

`--checklist`オプションはチェックリストを生成し、選択した値を返します。チェックリストの各オプションには３つの値を指定します:

- `タグ`;

- ダイアログに表示する説明的な`項目`;

- `on`か`off`のいず れかで指定される`ステータス`。これはチェックボックスがデフォルトでチェックされているか否かを指定します。

以下のスクリプトで示すように、選択された全ての`タグ` の値が返されます:

              #!/bin/sh

              if gdialog --title "チェックリスト" \
                         --checklist "チェックリストのオプションです" 300 300 100 \
                         "One" "一番目の項目" off \
                         "Two" "二番目の項目" on \
                         "Three" "三番目の項目" on \
                         "Four" "四番目の項目" on \
                         "Five" "五番目の項目" on
              then echo $@
              else echo "何も選択されませんでした"
              fi

### ラジオリスト

`--radiolist`オプションはリストを生成しますが、 一つの項目しか選択することができません。 `--radiolist`は`--checklist` と同じオプション指定をできますが、デフォルトの`ステー タス`に`on`を指定できるのがただ一 つの項目だけである点が異なります。複数の項目に対して `on`が指定された場合、&app;は最後の項目のみ をデフォルトで選択します。

### ゲージ

`--gauge`オプションを指定すると、プログレスバー が生成されます。高さと幅といった共通のパラメータに加え、最後の パラメータで表示される進捗のパーセンテージを指定します。例えば 以下のように実行します:

              gdialog --title "Gauge" --gauge "This is a gauge" 100 100 20

プログレスバーの値を変更するには、以下のようにSTDINから&app;に 値を渡します:

              #!/bin/sh

              (
                  echo "10" ; sleep 1
                  echo "20" ; sleep 1
                  echo "50" ; sleep 1
                  echo "75" ; sleep 1
                  echo "100" ; sleep 1
              ) |
              gdialog --title "ゲージ" --gauge "ゲージウィジェットです" 10 10 0

## 作者

gdialogはSavio Lam (lam836@cs.cuhk.hk)とStuart Herbert (S.Herbert@shef.ac.uk)によって書かれました。コメ ント、提案、バグレポートは全てGNOMEバグ追跡データ ベースに送ってください。メインメニュー のユーティリティサブメニュー にあるバグ報告ツール (`bug-buddy`)もバグレポートに利用できます。

このマニュアルはPatanjali Somayaji (patanjali@morelinux.com) とohn Fleck (jfleck@inkstain.net)によって書かれました。このマ ニュアルに関するコメントや提案は全てGNOMEドキュメンテー ションプロジェクトへdocs@gnome.orgにメー ルで送付してください。

日本語訳は鎌ヶ迫正俊 (emerald@gnome.gr.jp)による ものです。日本語訳に関するコメントや提案は全て gnome-translation@gnome.gr.jpもしくは emerald@gnome.gr.jpにメールで送付してください。

## ライセンス

このプログラムはフリーソフトウェアです。フリーソフトウェア財団発 行のGNU 一般 公有使用許諾契約書第二版あるいは(あなたの選 択で)後の版の下おいて再配布や改変することができます。

このプログラムは有用であることを期待して配布していますが、無保証 です。商業目的や特定の目的に適合した場合の暗黙の保証すら含まれて おりません。詳細はGNU 一般公有使用許諾契約書 をご覧ください。

GNU 一般公有使用許諾契約書の複写は GNOMEユーザーズガイドの付録として収録さ れています。GNU 一般公有使用許諾契約書 の複写はフリーソフトウェア財団から、彼らのウェブサイトを訪れるこ とにより、また、以下の住所に手紙を書くことによっても入手するこ とも可能です。

            Free Software Foundation, Inc.
            59 Temple Place - Suite 330
            Boston, MA 02111-1307
            USA