<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY author1 "Sun">
<!ENTITY author2 "Java Desktop System Documentation Team">
<!ENTITY publisher "Sun Microsystems, Inc.">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.6.0">
<!ENTITY app "<application>Zenity</application>">
<!ENTITY appname "Zenity">
<!ENTITY date "August 2004">
<!ENTITY manrevision "2.0">
]>
<!-- ================ Document Header ================= -->
<article id="index" lang="ca">

  <articleinfo>
    <title>Manual del Zenity</title>
    <subtitle>Manual de l'aplicació de l'escriptori Zenity v2.0</subtitle>
    <copyright>
	    <year>2003</year>
	    <year>2004</year>
	    <holder>Sun Microsystems, Inc.</holder>
    </copyright><copyright><year>2008</year><holder>Joan Duran (jodufi@gmail.com)</holder></copyright>

    <!-- Translators: uncomment this
    <copyright>
	    <year>2004</year>
	    <holder>ME_THE_TRANSLATOR</holder>
    </copyright>
    -->

    <publisher>
	    <publishername>Sun Microsystems, Inc.</publishername>
    </publisher>

      <legalnotice id="legalnotice">
	<para>Teniu permís per a copiar, distribuir i/o modificar aquest document, sota els termes de la Llicència de documentació lliure GNU (GFDL), versió 1.1 o qualsevol versió publicada posteriorment per la Free Software Foundation, sense seccions invariants, sense texts de portada i sense texts de contraportada. Podeu trobar una còpia de la GFDL en aquest <ulink type="help" url="ghelp:fdl">enllaç</ulink> o en el fitxer COPYING-DOCS distribuït amb aquest manual.</para>
         <para>Aquest manual forma part d'una col·lecció de manuals del GNOME distribuïts sota la GFDL. Si voleu distribuir aquest manual independentment de la col·lecció, podeu fer-ho afegint una còpia de la llicència al manual, tal com es descriu a la secció 6 de la llicència.</para>

	<para>Molts dels noms que les empreses utilitzen per a distingir els seus productes i serveis es consideren marques comercials. Quan aquests noms apareguin en qualsevol documentació del GNOME, si els membres del Projecte de documentació del GNOME han estat avisats pel que fa a les marques, els noms apareixeran en majúscules o amb les inicials en majúscules.</para>

	<para>EL DOCUMENT I LES VERSIONS MODIFICADES DEL DOCUMENT S'OFEREIXEN SOTA ELS TERMES DE LA LLICÈNCIA DE DOCUMENTACIÓ LLIURE DE GNU, TENINT EN COMPTE QUE: <orderedlist>
		<listitem>
		  <para>EL DOCUMENT S'OFEREIX «TAL COM ÉS», SENSE CAP TIPUS DE GARANTIA, NI EXPLÍCITA NI IMPLÍCITA; AIXÒ INCLOU, SENSE LIMITAR-S'HI, LES GARANTIES QUE EL DOCUMENT O LA VERSIÓ MODIFICADA DEL DOCUMENT NO TINGUI DEFECTES, SIGUI COMERCIALITZABLE, SIGUI ADEQUAT PER A UN ÚS CONCRET O NO INFRINGEIXI CAP LLEI. TOT EL RISC PEL QUE FA A LA QUALITAT, EXACTITUD I RENDIMENT DEL DOCUMENT O LA VERSIÓ MODIFICADA DEL DOCUMENT ÉS VOSTRE. EN CAS QUE EL DOCUMENT RESULTÉS DEFECTUÓS EN QUALSEVOL ASPECTE, VÓS (NO PAS L'ESCRIPTOR INICIAL, L'AUTOR O CAP ALTRE COL·LABORADOR) ASSUMIU TOT EL COST DE MANTENIMENT, REPARACIÓ O CORRECCIÓ. AQUESTA RENÚNCIA DE GARANTIA CONSTITUEIX UNA PART ESSENCIAL D'AQUESTA LLICÈNCIA. NO S'AUTORITZA L'ÚS DE CAP DOCUMENT O VERSIÓ MODIFICADA DEL DOCUMENT EXCEPTE SOTA AQUESTA RENÚNCIA DE GARANTIA; I</para>
		</listitem>
		<listitem>
		  <para>EN CAP CAS I SOTA CAP INTERPRETACIÓ LEGAL, JA SIGUI PER AGREUJAMENT (INCLOENT-HI LA NEGLIGÈNCIA), CONTRACTE O ALTRE CAS, L'AUTOR, L'ESCRIPTOR ORIGINAL, QUALSEVOL DELS COL·LABORADORS O DISTRIBUÏDORS DEL DOCUMENT O UNA VERSIÓ MODIFICADA DEL DOCUMENT NI CAP PROVEÏDOR D'AQUESTES PARTS NO SERAN RESPONSABLES DAVANT DE NINGÚ PER CAP DANY DIRECTE, INDIRECTE, ESPECIAL, ACCIDENTAL O CONSECUTIU DE QUALSEVOL TIPUS; AIXÒ INCLOU, SENSE LIMITAR-S'HI, ELS DANYS PER PÈRDUA DE CLIENTS, INTERRUPCIONS DE LA FEINA, FALLADA O MALFUNCIONAMENT DE L'ORDINADOR, O QUALSEVOL ALTRA PÈRDUA O DANY RELACIONAT AMB L'ÚS DEL DOCUMENT I LES VERSIONS MODIFICADES DEL DOCUMENT, FINS I TOT SI S'HA INFORMAT AQUESTA PART DE LA POSSIBILITAT D'AQUESTS DANYS.</para>
		</listitem>
	  </orderedlist></para>
  </legalnotice>



    <authorgroup>
      <author>
        <firstname>Sun</firstname>
        <surname>Equip de documentació del sistema d'escriptori de Java</surname>
        <affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
      </author>
      <author role="maintainer">
        <firstname>Glynn</firstname>
        <surname>Foster</surname>
        <affiliation>
          <orgname>Projecte de documentació del GNOME</orgname>
        </affiliation>
      </author>
      <editor>
        <firstname>Nicholas</firstname>
        <surname>Curran</surname>
        <affiliation>
          <orgname>Projecte de documentació del GNOME</orgname>
        </affiliation>
      </editor>
    </authorgroup>

    <revhistory>
      <revision>
        <revnumber>Manual de l'aplicació de l'escriptori Zenity v2.0</revnumber>
        <date>Agost de 2004</date>
        <revdescription>
          <para role="author">Equip de documentació del sistema d'escriptori de Sun Java</para>
          <para role="publisher">Sun Microsystems, Inc.</para>
        </revdescription>
      </revision>

      <revision>
        <revnumber>Manual del Zenity v1.0</revnumber>
        <date>Gener de 2003</date>
        <revdescription>
          <para role="author">Glynn Foster</para>
          <para role="publisher">Projecte de documentació del GNOME</para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>Aquest manual descriu la versió 2.6.0 del Zenity.</releaseinfo>

    <legalnotice>
	    <title>Comentaris</title>
	    <para>Per enviar comentaris, seguiu les indicacions de la <ulink url="ghelp:gnome-feedback" type="help">pàgina de comentaris</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>El Zenity és una reescriptura del gdialog, la versió del GNOME del diàleg que ús permet mostrar els diàlegs des de la línia d'ordres i scripts de l'intèrpret d'ordres.</para>
    </abstract>
  </articleinfo>
  
  <indexterm>
    <primary>ordre zenity</primary>
  </indexterm>
  <indexterm>
    <primary>creador de diàlegs</primary>
  </indexterm>
<!-- ================ Document Body ================= -->

<!-- ==== Introduction ====== -->

  <sect1 id="zenity-introduction">
    <title>Introducció</title>

    <para>El <application>Zenity</application> us permet crear els tipus de diàlegs senzills següents:</para>

    <itemizedlist>
        <listitem><para>Calendari</para></listitem>
	<listitem><para>Selecció de fitxers</para></listitem>
	<listitem><para>Llista</para></listitem>
	<listitem><para>Icona de notificació</para></listitem>
        <listitem><para>Missatge</para>
            <itemizedlist>
	        <listitem><para>Error</para></listitem>
		<listitem><para>Informació</para></listitem>
		<listitem><para>Pregunta</para></listitem>
		<listitem><para>Avís</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Progrés</para></listitem>
        <listitem><para>Entrada de text</para></listitem>
	<listitem><para>Text informatiu</para></listitem>
    </itemizedlist>

  </sect1>

<!-- ==== Usage ====== -->

  <sect1 id="zenity-usage">
    <title>Utilització</title>

    <para>Quan escriviu scripts, podeu utilitzar el <application>Zenity</application> per crear diàlegs senzills que interactuen gràficament amb l'usuari. Funciona així:</para>
    <itemizedlist>
      <listitem>
        <para>Podeu crear un diàleg per obtenir informació de l'usuari. Per exemple, podeu sol·licitar a l'usuari que seleccioni una data d'un diàleg de calendari o que seleccioni un fitxer d'un diàleg de selecció de fitxers.</para>
      </listitem>
      <listitem>
        <para>Podeu crear un diàleg per proporcionar informació a l'usuari. Per exemple, podeu utilitzar un diàleg de progrés per indicar l'estat actual d'una operació o utilitzar el diàleg de missatge d'avís per alertar a l'usuari.</para>
      </listitem>
    </itemizedlist>
    <para>Qual l'usuari tanca el diàleg, el <application>Zenity</application> imprimeix el text produït pel diàleg a la sortida estàndard.</para>

    <note>
      <para>Quan escriviu ordres del <application>Zenity</application>, assegureu-vos que poseu cometes al voltant de cada argument.</para>
      <para>Per exemple, utilitzeu: <screen><userinput><command>zenity --calendar --title="Planificació de les vacances"</command></userinput></screen> No utilitzeu: <screen><userinput><command>zenity --calendar --title=Planificació de les vacances</command></userinput></screen></para>
      <para>Si no utilitzeu les cometes no obtindreu els resultats esperats.</para>
    </note>

    <sect2 id="zenity-usage-mnemonics">
      <title>Tecles d'accés</title>
	<para>Una tecla d'accés és una tecla que us permet realitzar una acció des del teclat enlloc d'utilitzar el ratolí per a seleccionar una ordre des d'un menú o diàleg. Cada tecla d'accés està identificada per una lletra subratllada en l'opció d'un menú o d'un diàleg.</para>
	<para>Alguns diàlegs del <application>Zenity</application> admeten la utilització de tecles d'accés. Per especificar el caràcter a utilitzar com a tecla d'accés, col·loqueu un caràcter subratllat abans del caràcter al text del diàleg. L'exemple següent mostra com especificar la lletra «T» com a tecla d'accés:</para>
	<screen><userinput>«_Trieu un nom».</userinput></screen>
    </sect2>

    <sect2 id="zenity-usage-exitcodes">
      <title>Codis de sortida</title>
    <para>El <application>Zenity</application> retorna els codis de sortida següents:</para>

    <informaltable frame="all">
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="COLSPEC0" colwidth="50*"/>
        <colspec colname="COLSPEC1" colwidth="50*"/>
        <thead>
          <row valign="top">
            <entry colname="COLSPEC0">
              <para>Codi de sortida</para></entry>
            <entry colname="COLSPEC1">
              <para>Descripció</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para><varname>0</varname></para>
            </entry>
            <entry>
              <para>L'usuari ha premut <guibutton>D'acord</guibutton> o <guibutton>Tanca</guibutton>.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para><varname>1</varname></para>
            </entry>
            <entry>
              <para>L'usuari ha premut <guibutton>Cancel·la</guibutton> o ha utilitzat les funcions de la finestra per a tancar el diàleg.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para><varname>-1</varname></para>
            </entry>
            <entry>
              <para>S'ha produït un error inesperat.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para><varname>5</varname></para>
            </entry>
            <entry>
              <para>S'ha tancat el diàleg perquè s'ha acabat el temps d'espera.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


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

  <sect2 id="zenity-usage-general-options">
    <title>Opcions generals</title>

    <para>Tots els diàlegs del <application>Zenity</application> admeten les opcions generals següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>títol</replaceable></term>
	<listitem>
	  <para>Especifica el títol d'un diàleg.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>ruta_de_la_icona</replaceable></term>
	<listitem>
	  <para>Especifica la icona que es mostrarà al marc de la finestra del diàleg. També podeu utilitzar 4 icones predefinides si proporcioneu les paraules clau següents: «info» (informació), «warning» (avís), «question» (pregunta) i «error» (error).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>amplada</replaceable></term>
	<listitem>
	  <para>Especifica l'amplada del diàleg.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>alçada</replaceable></term>
	<listitem>
	  <para>Especifica l'alçada del diàleg.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--timeout</option>=<replaceable>temps d'espera</replaceable></term>
	<listitem>
	  <para>Especifica el temps d'espera, en segons, passats els quals es tancarà el diàleg.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

  <sect2 id="zenity-help-options">
    <title>Opcions d'ajuda</title>

    <para>El <application>Zenity</application> proporciona les opcions d'ajuda següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--help</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda abreviat.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--help-all</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda complet per tots els diàlegs.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-general</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions generals dels diàlegs.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-calendar</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg de calendari.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-entry</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg d'entrada de text.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-error</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg d'error.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-info</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg informatiu.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-file-selection</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg de selecció de fitxers.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-list</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg de llista.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-notification</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions de la icona de notificació.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-progress</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg de progrés.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-question</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg de pregunta.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-warning</option></term>
	<listitem>
	  <para>Mostra el text d'ajuda de les opcions del diàleg d'avís.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-text-info</option></term>
	<listitem>
	  <para>Mostra l'ajuda de les opcions del diàleg de text informatiu.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-misc</option></term>
	<listitem>
	  <para>Mostra l'ajuda de les opcions miscel·lànies.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--help-gtk</option></term>
	<listitem>
	  <para>Mostra l'ajuda de les opcions de la GTK+.</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

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

  <sect2 id="zenity-miscellaneous-options">
    <title>Opcions miscel·lànies</title>

    <para>El <application>Zenity</application> també proporciona les opcions misel·lànies següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--about</option></term>
	<listitem>
	  <para>Mostra el diàleg <guilabel>Quant al Zenity</guilabel>, que conté informació de la versió, del copyright i de desenvolupament del <application>Zenity</application>.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--version</option></term>
	<listitem>
	  <para>Mostra el número de versió del <application>Zenity</application>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

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

  <sect2 id="zenity-gtk-options">
    <title>Opcions de la GTK+</title>

    <para>El <application>Zenity</application> admet les opcions estàndard de la GTK+. Per obtenir més informació sobre les opcions de la GTK+, executeu l'ordre <command>zenity -?</command>.</para>

  </sect2>

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

  <sect2 id="zenity-environment-variables">
    <title>Variables d'entorn</title>

    <para>Normalment el <application>Zenity</application> detecta la finestra del terminal des d'on s'ha executat i es manté sobre d'aquesta. Aquest comportament es pot desactivar amb la variable d'entorn <envar>WINDOWID</envar>.</para>

  </sect2>

  </sect1>
<!-- ==== Calendar Options ====== -->

  <sect1 id="zenity-calendar-options">
    <title>Diàleg de calendari</title>

    <para>Utilitzeu l'opció <option>--calendar</option> per crear un diàleg de calendari. El <application>Zenity</application> retorna la data seleccionada a la sortida estàndard. Si no s'ha especificat cap data a la línia d'ordres, el diàleg utilitza la data actual.</para>
    <para>El diàleg de calendari admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Especifica el text que es mostra al diàleg del calendari.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>dia</replaceable></term>
	<listitem>
	  <para>Especifica el dia que hi ha seleccionat al diàleg del calendari. El <replaceable>dia</replaceable> ha de ser un número entre 1 i 31 inclosos.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>mes</replaceable></term>
	<listitem>
	  <para>Especifica el mes que hi ha seleccionat al diàleg del calendari. El <replaceable>mes</replaceable> ha de ser un número entre 1 i 12 inclosos.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>any</replaceable></term>
	<listitem>
	  <para>Especifica l'any hi ha seleccionat al diàleg del calendari.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>format</replaceable></term>
	<listitem>
	  <para>Especifica el format que es retorna des del diàleg del calendari després de seleccionar la data. El format predeterminat depèn de la configuració regional. El <replaceable>format</replaceable> ha de ser un format acceptable per a la funció <command>strftime</command>, per exemple: <literal>%A %d/%m/%y</literal>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg de calendari: <programlisting>
        #!/bin/sh


        if zenity --calendar \
        --title="Seleccioneu una data" \
        --text="Feu clic a una data per a seleccionar-la." \
        --day=23 --month=11 --year=2008
          then echo $?
          else echo "No s'ha seleccionat cap data"
        fi
      </programlisting></para>

    <figure id="zenity-calendar-screenshot">
      <title>Exemple de diàleg de calendari</title>
      <screenshot>
        <mediaobject>
          <imageobject>
              <imagedata fileref="figures/zenity-calendar-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase>Exemple de diàleg de calendari del <application>Zenity</application></phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>


<!-- ==== File Selection Options ====== -->

  <sect1 id="zenity-file-selection-options">
    <title>Diàleg de selecció de fitxers</title>

    <para>Utilitzeu l'opció <option>--file-selection</option> per a crear un diàleg de selecció de fitxers. El <application>Zenity</application> retorna els fitxers o directoris seleccionats a la sortida estàndard. El mode per defecte del diàleg de selecció de fitxers és obrir.</para>
    <para>El diàleg de selecció de fitxers admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>nom_de_fitxer</replaceable></term>
	<listitem>
	  <para>Especifica el fitxer o directori que està seleccionat al diàleg de selecció de fitxers quan es mostra el diàleg per primer cop.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--multiple</option></term>
	<listitem>
	  <para>Permet la selecció de diversos noms de fitxer al diàleg de selecció de fitxers.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--directory</option></term>
	<listitem>
	  <para>Només permet la selecció de directoris al diàleg de selecció de fitxers.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--save</option></term>
	<listitem>
	  <para>Estableix el diàleg de selecció de fitxers al mode de desar.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>separador</replaceable></term>
	<listitem>
	  <para>Especifica la cadena que s'utilitza per a dividir la llista de noms de fitxers retornada.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg de selecció de fitxers: <programlisting>
        #!/bin/sh

        FILE=`zenity --file-selection --title="Seleccioneu un fitxer"`

        case $? in
                 0)
                        echo "S'ha seleccionat \"$FILE\".";;
                 1)
                        echo "No s'ha seleccionat cap fitxer.";;
                -1)
                        echo "No s'ha seleccionat cap fitxer.";;
        esac
      </programlisting></para>

    <figure id="zenity-fileselection-screenshot">
      <title>Exemple de diàleg de selecció de fitxers</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-fileselection-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Exemple de diàleg de selecció de fitxers del <application>Zenity</application></phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Notification Options ====== -->
  <sect1 id="zenity-notification-options">
    <title>Icona de notificació</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Especifica el text que es mostra a l'àrea de notificació.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear una icona de notificació: <programlisting>
        #!/bin/sh

        zenity --notification\
          --window-icon="info" \
          --text="Hi ha actualitzacions necessàries per al sistema."
      </programlisting></para>

    <figure id="zenity-notification-screenshot">
      <title>Exemple d'icona de notificació</title>
      <screenshot>
        <mediaobject>
          <imageobject>
              <imagedata fileref="figures/zenity-notification-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase>Exemple d'icona de notificació del <application>Zenity</application></phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>

<!-- ==== List Options ====== -->

  <sect1 id="zenity-list-options">
    <title>Diàleg de llista</title>

    <para>Utilitzeu l'opció <option>--list</option> per crear un diàleg de llista. El <application>Zenity</application> retorna les entrades de la primera columna de text de les files seleccionades a la sortida estàndard.</para>

    <para>Les dades del diàleg s'han d'especificar columna per columna, fila per fila. Les dades es poden proporcionar al diàleg a través de l'entrada estàndard. Cada entrada s'ha de separar per un caràcter de línia nova.</para>

    <para>Si utilitzeu les opcions <option>--checklist</option> o <option>--radiolist</option>, cada fila ha de començar amb «TRUE» (cert) o «FALSE» (fals).</para>

    <para>El diàleg de llista admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>columna</replaceable></term>
	<listitem>
	  <para>Especifica les capçaleres de la columna que es mostren al diàleg de llista. Heu d'especificar una opció de <option>--column</option> per a cada columna que voleu mostrar al diàleg.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--checklist</option></term>
	<listitem>
	  <para>Especifica que la primera columna del diàleg de llista conté caselles de selecció.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--radiolist</option></term>
	<listitem>
	  <para>Especifica que la primera columna del diàleg de llista conté botons d'opció.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--editable</option></term>
	<listitem>
	  <para>Permet que s'editin els elements mostrats.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>separador</replaceable></term>
	<listitem>
	  <para>Especifica quina cadena s'utilitza quan el diàleg de llista retorna les entrades seleccionades.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>columna</replaceable></term>
	<listitem>
	  <para>Especifica quina columna s'hauria d'imprimir si es selecciona. La columna per defecte és «1». Es pot utilitzar «ALL» (totes) per a imprimir totes les columnes de la llista.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg de llista: <programlisting>
        #!/bin/sh

        zenity --list \
          --title="Trieu els errors que voleu visualitzar" \
          --column="Número de l'error" --column="Severitat" --column="Descripció" \
            992383 Normal "El GtkTreeView falla en seleccions múltiples" \
            293823 Alta "El diccionari del GNOME no gestiona servidors intermediaris" \
            393823 Crítica "L'edició del menú no funciona al GNOME 2.0"
      </programlisting></para>

    <figure id="zenity-list-screenshot">
      <title>Exemple de diàleg de llista</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-list-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Exemple de diàleg de llista del <application>Zenity</application></phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Message Options ====== -->

  <sect1 id="zenity-message-options">
    <title>Diàlegs de missatge</title>

    <para>El <application>Zenity</application> pot crear quatre tipus de diàlegs de missatge:</para>
    <itemizedlist>
      <listitem>
        <para>Error</para>
      </listitem>
      <listitem>
        <para>Informació</para>
      </listitem>
      <listitem>
        <para>Pregunta</para>
      </listitem>
      <listitem>
        <para>Avís</para>
      </listitem>
    </itemizedlist>

    <para>Per a cada tipus, utilitzeu l'opció <option>--text</option> per especificar el text que es mostra al diàleg.</para>

    <sect2 id="zenity-error-dialog">
      <title>Diàleg d'error</title>

      <para>Utilitzeu l'opció <option>--error</option> per crear un diàleg d'error.</para>

      <para>L'script d'exemple següent mostra com crear un diàleg d'error: <programlisting>
          #!/bin/bash

          zenity --error \
          --text="No es pot trobar /var/log/syslog."
        </programlisting></para>

      <figure id="zenity-error-screenshot">
        <title>Exemple de diàleg d'error</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-error-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Exemple de diàleg d'error del <application>Zenity</application></phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-info-dialog">
      <title>Diàleg d'informació</title>

      <para>Utilitzeu l'opció <option>--info</option> per crear un diàleg d'informació.</para>

      <para>L'script d'exemple següent mostra com crear un diàleg d'informació: <programlisting>
          #!/bin/bash

          zenity --info \
          --text="S'ha completat la combinació. S'han actualitzat 3 de 10 fitxers."
        </programlisting></para>

      <figure id="zenity-information-screenshot">
        <title>Exemple de diàleg d'informació</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-information-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Exemple de diàleg d'informació del <application>Zenity</application></phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-question-dialog">
      <title>Diàleg de pregunta</title>

      <para>Utilitzeu l'opció <option>--question</option> per crear un diàleg de pregunta.</para>

      <para>L'script d'exemple següent mostra com crear un diàleg de pregunta: <programlisting>
          #!/bin/bash

          zenity --question \
          --text="Segur que voleu continuar?"
        </programlisting></para>

      <figure id="zenity-question-screenshot">
        <title>Exemple de diàleg de pregunta</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-question-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Exemple de diàleg de pregunta del <application>Zenity</application></phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-warning-dialog">
      <title>Diàleg d'avís</title>

      <para>Utilitzeu l'opció <option>--warning</option> per crear un diàleg d'avís.</para>

      <para>L'script d'exemple següent mostra com crear un diàleg d'avís: <programlisting>
          #!/bin/bash
        
          zenity --warning \
          --text="Desconnecteu el cable d'alimentació per a evitar una descàrrega elèctrica."
        </programlisting></para>

      <figure id="zenity-warning-screenshot">
        <title>Exemple de diàleg d'avís</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-warning-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Exemple de diàleg d'avís del <application>Zenity</application></phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

  </sect1>

<!-- ==== Progress Options ====== -->

  <sect1 id="zenity-progress-options">
    <title>Diàleg de progrés</title>

    <para>Utilitzeu l'opció <option>--progress</option> per crear un diàleg de progrés.</para>

    <para>El <application>Zenity</application> llegeix dades de l'entrada estàndard línia per línia. Si una línia té el prefix #, el text s'actualitza amb el text d'aquesta línia. Si una línia només conté un número, el percentatge s'actualitza amb aquest número.</para>
	
    <para>El diàleg de progrés admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Especifica el text que es mostrarà al diàleg de progrés.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>percentatge</replaceable></term>
	<listitem>
	  <para>Especifica els percentatge inicial que s'estableix al diàleg de progrés.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--auto-close</option></term>
	<listitem>
	  <para>Tanca el diàleg de progrés quan s'arribi al 100%.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--pulsate</option></term>
	<listitem>
	  <para>Especifica que la barra de progrés parpellegi fins que es llegeixi un caràcter EOF (final de fitxer) de l'entrada estàndard.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg de progrés: <programlisting>
        #!/bin/sh
        (
        echo "10" ; sleep 1
        echo "# S'estan actualitzant els registres del correu" ; sleep 1
        echo "20" ; sleep 1
        echo "# S'estan reiniciant les tasques del cron" ; sleep 1
        echo "50" ; sleep 1
        echo "Aquesta línia s'ignorarà" ; sleep 1
        echo "75" ; sleep 1
        echo "# S'està reiniciant el sistema" ; sleep 1
        echo "100" ; sleep 1
        ) |
        zenity --progress \
          --title="Actualització dels registres del sistema" \
          --text="Comprovació dels registres del sistema..." \
          --percentage=0

        if [ "$?" = -1 ] ; then
                zenity --error \
                  --text="Actualització cancel·lada."
        fi

      </programlisting></para>

    <figure id="zenity-progress-screenshot">
      <title>Exemple de diàleg de progrés</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-progress-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Exemple de diàleg de progrés del <application>Zenity</application></phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Text Entry Options ====== -->

  <sect1 id="zenity-text-entry-options">
    <title>Diàleg d'entrada de text</title>

    <para>Utilitzeu l'opció <option>-entry</option> per crear un diàleg d'entrada de text. El <application>Zenity</application> retorna els continguts de l'entrada de text a la sortida estàndard.</para>	
    <para>El diàleg d'entrada de text admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Especifica el text que es mostra al diàleg d'entrada de text.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>text</replaceable></term>
	<listitem>
	  <para>Especifica el text que es mostra al camp d'entrada del diàleg d'entrada de text.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--hide-text</option></term>
	<listitem>
	  <para>Amaga el text del camp d'entrada del diàleg d'entrada de text.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg d'entrada de text: <programlisting>
        #!/bin/sh

        if zenity --entry \
        --title="Afegeix una entrada" \
        --text="Introduïu la _contrasenya:" \
        --entry-text "contrasenya" \
        --hide-text
          then echo $?
          else echo "No s'ha introduït cap contrasenya"
        fi
      </programlisting></para>

    <figure id="zenity-entry-screenshot">
      <title>Exemple de diàleg d'entrada de text</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-entry-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Exemple de diàleg d'entrada de text del <application>Zenity</application></phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>

<!-- ==== Text Information Options ====== -->

  <sect1 id="zenity-text-options">
    <title>Diàleg de text informatiu</title>

    <para>Utilitzeu l'opció <option>--text-info</option> per crear un diàleg de text informatiu.</para>
	
    <para>El diàleg de text informatiu admet les opcions següents:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>nom_de_fitxer</replaceable></term>
	<listitem>
	  <para>Especifica el fitxer que es carregarà al diàleg de text informatiu.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--editable</option></term>
        <listitem>
          <para>Permet que el text mostrat es pugui editar. El text editat es retorna a la sortida estàndard quan es tanca el diàleg.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para>L'script d'exemple següent mostra com crear un diàleg de text informatiu: <programlisting>
        #!/bin/sh

        FILE=`zenity --file-selection \
          --title="Seleccioneu un fitxer"`

        case $? in
                 0)
                        zenity --text-info \
                          --title=$FILE \
                          --filename=$FILE \
                          --editable 2&gt;/tmp/tmp.txt;;
                 1)
                        echo "No s'ha seleccionat cap fitxer.";;
                -1)
                        echo "No s'ha seleccionat cap fitxer.";;
        esac
      </programlisting></para>

    <figure id="zenity-text-screenshot">
      <title>Exemple del diàleg de text informatiu</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-text-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Exemple del diàleg de text informatiu del <application>Zenity</application></phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

</article>
