<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="pt-BR">
<info>
  <link type="guide" xref="index"/>
  <desc>You can use <app>Zenity</app> to create simple dialogs that interact graphically with the user.</desc>
</info>
<title>Modo de uso</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>Você pode criar um diálogo para obter informações do usuáro. Por exemplo, você pedir ao usuário que selecione uma data em um diálogode calendário ou para escolher um arquivo por um diálogo de seleção de arquivo.</p>
      </item>
      <item>
        <p>Você pode criar um diálogo para prover informações ao usuário. Por exemplo, você pode usar um diálogo indicador de progresso para indicar o estado atual de uma operação ou usar um diálogo de mensagem de aviso para alertar o usuário.</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>Se você não utilizar as aspas, pode obter resultados inesperados.</p>
    </note>

    <section id="zenity-usage-mnemonics">
      <title>Teclas de acesso</title>
	<p>Uma tecla de acesso é aquela que lhe habilita desempenhar uma ação a partir do teclado, em vez de usar o mouse, para escolher um comando de um menu ou de um diálogo. Cada tecla de acesso é identificada por uma letra sublinhada em uma opção do menu ou do diálogo.</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>"_Choose a name".</input></screen>
    </section>

    <section id="zenity-usage-exitcodes">
      <title>Códigos de saída</title>
    <p>
        Zenity returns the following exit codes:
    </p>

    <table frame="all" rules="all">
        <thead>
          <tr valign="top">
            <td colname="COLSPEC0">
              <p>Código de saída</p></td>
            <td colname="COLSPEC1">
              <p>Descrição</p></td>
          </tr>
        </thead>
        <tbody>
          <tr valign="top">
            <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 valign="top">
            <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 valign="top">
            <td>
              <p><var>-1</var></p>
            </td>
            <td>
              <p>Ocorreu um erro inesperado.</p>
            </td>
          </tr>
          <tr valign="top">
            <td>
              <p><var>5</var></p>
            </td>
            <td>
              <p>O diálogo foi fechado porque o tempo de espera se esgotou.</p>
            </td>
          </tr>
        </tbody>
    </table>

    </section>


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

  <section id="zenity-usage-general-options">
    <title>Opções gerais</title>

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

    <terms>

      <item>
        <title><cmd>--title</cmd>=<var>title</var></title>
	<p>Especifica o título de um diálogo.</p>
      </item>

      <item>
        <title><cmd>--window-icon</cmd>=<var>icon_path</var></title>
	<p>Especifica o ícone que é exibido na moldura do diálogo. Existem 4 ícones pré-definidos que também estão disponíveis ao usar as seguintes palavras-chave - "info", "warning" (aviso), "question" (pergunta) e "error" (erro).</p>
      </item>

      <item>
        <title><cmd>--width</cmd>=<var>width</var></title>
	<p>Especifica a largura do diálogo.</p>
      </item>

      <item>
        <title><cmd>--height</cmd>=<var>height</var></title>
	<p>Especifica a altura do diálogo.</p>
      </item>

      <item>
        <title><cmd>--timeout</cmd>=<var>timeout</var></title>
	<p>Especifica o tempo de espera em segundos depois do qual o diálogo será fechado.</p>
      </item>

    </terms>

  </section>

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

  <section id="zenity-help-options">
    <title>Opções de ajuda</title>

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

    <terms>

      <item>
        <title><cmd>--help</cmd></title>
	<p>Exibe o texto resumido de ajuda.</p>
      </item>

      <item>
        <title><cmd>--help-all</cmd></title>
	<p>Exibe o texto completo de ajuda para todos os diálogos.</p>
      </item>
 
      <item>
        <title><cmd>--help-general</cmd></title>
	<p>Exibe os textos de ajuda para opções gerais de diálogos.</p>
      </item>
 
      <item>
        <title><cmd>--help-calendar</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de calendário.</p>
      </item>
 
      <item>
        <title><cmd>--help-entry</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de entrada de texto.</p>
      </item>
 
      <item>
        <title><cmd>--help-error</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de erro.</p>
      </item>
 
      <item>
        <title><cmd>--help-info</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de informação.</p>
      </item>
 
      <item>
        <title><cmd>--help-file-selection</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de seleção de arquivo.</p>
      </item>
 
      <item>
        <title><cmd>--help-list</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de lista.</p>
      </item>
 
      <item>
        <title><cmd>--help-notification</cmd></title>
	<p>Exibe o texto de ajuda para as opções de ícones de notificação.</p>
      </item>
 
      <item>
        <title><cmd>--help-progress</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo indicador de progresso.</p>
      </item>
 
      <item>
        <title><cmd>--help-question</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de pergunta.</p>
      </item>
 
      <item>
        <title><cmd>--help-warning</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de aviso.</p>
      </item>
 
      <item>
	<title><cmd>--help-text-info</cmd></title>
	<p>Exibe o texto de ajuda para as opções do diálogo de informação de texto.</p>
      </item>
 
      <item>
        <title><cmd>--help-misc</cmd></title>
	<p>Exibe o texto de ajuda para outras opções.</p>
      </item>
 
      <item>
        <title><cmd>--help-gtk</cmd></title>
	<p>Exibe ajuda para as opções do GTK+.</p>
      </item>
 
    </terms>

  </section>

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

  <section id="zenity-miscellaneous-options">
    <title>Outras opções</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>Opções do GTK+</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>Variáveis de ambiente</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>
