<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" lang="ja">
<info>
  <link type="guide" xref="index"/>
  <desc><app>Zenity</app> を使えば、ユーザーと視覚的に対話する簡単なダイアログを作成できます。</desc>
  <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), Version 1.1 or any later version published
	  by the Free Software Foundation with no Invariant Sections,
	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
	  a copy of the GFDL at this
	  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.</p>

	<p>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</p>

	<p>
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:
	</p>
	<list>
		<item>
		  <p>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND</p>
		</item>
		<item>
		  <p>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
		</item>
	  </list>
</license>
<credit type="translator copyright"><name>赤星　柔充</name><email>yasumichi@vinelinux.org</email><years>2011,2012</years></credit></info>
<title>使用法</title>
    <p>スクリプトを書く際に <app>Zenity</app> を使えば、以下のようにユーザーと視覚的に対話する簡単なダイアログを作成できます。</p>
    <list>
      <item>
        <p>ユーザーからの情報を取得するダイアログを作成できます。たとえば、カレンダーから日付を選択したり、ファイル選択ダイアログからファイルを選択したりするようにユーザーに求めることができます。</p>
      </item>
      <item>
        <p>ユーザーに情報を提供するダイアログが作成できます。たとえば、処理の現在の状況を示す進捗表示ダイアログやユーザーに注意を促す警告メッセージダイアログを使用できます。</p>
      </item>
    </list>
    <p>ユーザーがダイアログを閉じると <app>Zenity</app> は標準出力へダイアログにより作成されたテキストを出力します。</p>

    <note>
      <p><app>Zenity</app> コマンドを書く時は、確実に各引数を引用符で囲むようにしてください。</p>
      <p>たとえば、次のように使います。</p>
      <screen>zenity --calendar --title="Holiday Planner"</screen>
      <p>次のように使ってはいけません。</p>
      <screen>zenity --calendar --title=Holiday Planner</screen>
      <p>引用符を利用しない場合、予期せぬ結果を招く恐れがあります。</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>アクセスキー</title>
	<p>アクセスキーは、メニューやダイアログからマウスでコマンドを選択する代わりにキーボードで操作ができるようにするキーです。それぞれのアクセスキーは、メニューやダイアログのオプションで下線によって識別されます。</p>
	<p>いくつかの <app>Zenity</app> ダイアログは、アクセスキーの利用をサポートしています。アクセスキーとして利用する文字を指定するには、ダイアログのテキスト内にあるアクセスキーにしたい文字の前にアンダースコア (_) を置いてください。以下の例は、アクセスキーとして文字 'C' を指定する方法を示しています。</p>
	<screen><input>"名前の選択(_C)"</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>終了コード</title>
    <p>Zenity は、以下の終了コードを返します。</p>

    <table frame="all" rules="all">
        <thead>
          <tr>
            <td>
              <p>終了コード</p></td>
            <td>
              <p>説明</p></td>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>ユーザーが、<gui style="button">OK</gui> か <gui style="button">閉じる</gui>を押しました。</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>ユーザーが<gui style="button">キャンセル</gui>を押したか、ウィンドウの機能を利用してダイアログを閉じました。</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>予期しないエラーが発生しました。</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>タイムアウトに達したため、ダイアログが閉じました。</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


  <!-- ==== General Options ====== -->

  <section id="zenity-usage-general-options">
    <title>汎用的なオプション</title>

    <p>すべての Zenity ダイアログは、以下の汎用的なオプションをサポートしています。</p>

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>タイトル</var></title>
	<p>ダイアログのタイトルを指定します。</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>幅</var></title>
	<p>ダイアログの幅を指定します。</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>高さ</var></title>
	<p>ダイアログの高さを指定します。</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>タイムアウト</var></title>
	<p>ダイアログが閉じるまでのタイムアウト値を秒数で指定します。</p>
      </item>

    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-help-options">
    <title>ヘルプのオプション</title>

    <p>Zenity は、以下のヘルプのオプションを提供しています。</p>

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>簡単なヘルプを表示します。</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>すべてのダイアログに関する完全なヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>汎用的なオプションを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>カレンダーダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>テキスト入力ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>エラーダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>情報ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>ファイル選択ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>一覧ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>通知アイコンのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>進捗表示ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>質問ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>警告ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>テキスト情報ダイアログのオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>種々雑多なオプションに関するヘルプを表示します。</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>GTK+ のオプションに関するヘルプを表示します。</p>
      </item>
 
    </terms>

  </section>

<!-- ==== Miscellaneous Options ====== -->

  <section id="zenity-miscellaneous-options">
    <title>種々雑多なオプション</title>

    <p>Zenity は、以下のような種々雑多なオプションも提供しています。</p>

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Zenity のバージョン情報、著作権情報および開発者の情報を含んだ「<gui>Zenity について</gui>」というダイアログを表示します。</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Zenity のバージョン番号を標準出力に表示します。</p>
      </item>

    </terms>

  </section>

<!-- ==== GTK+ Options ====== -->

  <section id="zenity-gtk-options">
    <title>GTK+ のオプション</title>

    <p>Zenity は、標準的な GTK+ のオプションをサポートしています。GTK+ のオプションについての詳細は、<cmd>zenity --help-gtk</cmd> というコマンドを実行して確認してください。</p>

  </section>

<!-- ==== Environment variables ==== -->

  <section id="zenity-environment-variables">
    <title>環境変数</title>

    <p>通常、Zenity は自身が起動された端末ウィンドウを検出し、そのウィンドウより前面に位置し続けます。この振る舞いは、<var>WINDOWID</var> という環境変数の定義を解除することにより、無効にできます。</p>

  </section>
</page>
