<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="zenity-eu">
<info>
  <link type="guide" xref="index"/>
  <desc>You can use <app>Zenity</app> to create simple dialogs that interact graphically with the user.</desc>
  <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
</info>
<title>Erabilera</title>
    <p>
	When you write scripts, you can use <app>Zenity</app> to create simple dialogs that interact graphically with the user, as follows:
    </p>
    <list>
      <item>
        <p>Erabiltzaileagandik informazioa lortzeko, elkarrizketa-koadro bat sor dezakezu. Esaterako, erabiltzaileari eska diezaiokezu elkarrizketa-koadroko egutegitik data bat aukeratu dezan, edo elkarrizketa-koadroko fitxategi-hautapenetik fitxategi bat hauta dezan.</p>
      </item>
      <item>
        <p>Erabiltzaileari informazioa emateko, elkarrizketa-koadro bat sor dezakezu. Esaterako, eragiketa baten egoera adierazteko, elkarrizketa-koadroko progresio-barra erabil dezakezu, edo, erabiltzailea ohartarazteko, elkarrizketa-koadroko abisu bat.</p>
      </item>
    </list>
    <p>
	When the user closes the dialog, <app>Zenity</app> prints the text produced by the dialog to standard output.
    </p>

    <note>
      <p>
        When you write <app>Zenity</app> commands, ensure that you place quotation marks around each argument. 
      </p>
      <p>For example, use:</p>
      <screen>zenity --calendar --title="Holiday Planner"</screen>
      <p>Do not use:</p>
      <screen>zenity --calendar --title=Holiday Planner</screen>
      <p>Komatxo artean jartzen ez baduzu, ustekabeko emaitzak lortuko dituzu.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Tekla bizkortzaileak</title>
	<p>Teklatua erabiliz menu bateko edo elkarrizketa-koadro bateko komando bat sagua erabili gabe aukeratzeko modua eskaintzen dizu tekla bizkortzaileak. Menu edo elkarrizketa-koadroetako aukera bakoitzean azpimarratuta dagoen letra da bizkortzailea.</p>
	<p>
          Some <app>Zenity</app> dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:
	</p>
	<screen><input>"_Aukeratu izen bat".</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Irteera-kodeak</title>
    <p>
        Zenity returns the following exit codes:
    </p>

    <table frame="all" rules="all">
        <thead>
          <tr>
            <td>
              <p>Irteera-kodea</p></td>
            <td>
              <p>Azalpena</p></td>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <p><var>0</var></p>
            </td>
            <td>
              <p>The user has pressed either <gui style="button">OK</gui> or <gui style="button">Close</gui>.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>1</var></p>
            </td>
            <td>
              <p>The user has either pressed <gui style="button">Cancel</gui>, or used the window functions to close the dialog.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Ustekabeko errorea gertatu da.</p>
            </td>
          </tr>
          <tr>
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>The dialog has been closed because the timeout has been reached.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


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

  <section id="zenity-usage-general-options">
    <title>Aukera orokorrak</title>

    <p>
	All Zenity dialogs support the following general options:
    </p>

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>izenburua</var></title>
	<p>Elkarrizketa-koadroaren titulua zehazten du.</p>
      </item>

      <item>
        <title><cmd>--window-icon</cmd>=<var>ikono_bidea</var></title>
	<p>Elkarrizketa-koadroaren leiho-markoetan bistaratu den ikonoa zehazten du. 4 ikono daude erabilgarri gako-hitz hauek sartuz gero - 'info', 'warning', 'question' eta 'error'.</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>zabalera</var></title>
	<p>Elkarrizketa-koadroaren zabalera zehazten du.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>altuera</var></title>
	<p>Elkarrizketa-koadroaren altuera zehazten du.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>denbora-muga</var></title>
	<p>Specifies the timeout in seconds after which the dialog is closed.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-help-options">
    <title>Laguntza-aukerak</title>

    <p>
	Zenity provides the following help options:
    </p>

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Laguntza-testu murriztua ematen du.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Elkarrizketa-koadro guztietarako laguntza-testu osoa bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Elkarrizketa-koadroen aukera orokorretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Egutegiaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Hasierako testuaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Erroreen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Fitxategi-hautapenaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Zerrendaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Jakinarazpen-ikonoaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Progresio-barraren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Galderen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Abisuen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Testu-informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Aukera askotarako laguntza bistaratzen du.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>GTK aukeretarako laguntza bistaratzen du.</p>
      </item>
 
    </terms>

  </section>

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

  <section id="zenity-miscellaneous-options">
    <title>Askotariko aukerak</title>

    <p>
	Zenity also provides the following miscellaneous options:
    </p>

    <terms>

      <item>
        <title><cmd>--about</cmd></title>
	<p>Displays the <gui>About Zenity</gui> dialog, which contains Zenity version information, copyright information, and developer information.</p>
      </item>

      <item>
        <title><cmd>--version</cmd></title>
	<p>Displays the version number of Zenity.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-gtk-options">
    <title>GTK+ aukerak</title>

    <p>
	Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the <cmd>zenity --help-gtk</cmd> command.
    </p>

  </section>

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

  <section id="zenity-environment-variables">
    <title>Ingurune-aldagaiak</title>

    <p>
      Normally, Zenity detects the terminal window from which it was launched
      and keeps itself above that window.  This behavior can be disabled by
      unsetting the <var>WINDOWID</var> environment variable.
    </p>

  </section>
</page>
