Podeu utilitzar el Zenity per a crear diàlegs senzills que interactuen gràficament amb l'usuari.
Joan Duran
jodufi@gmail.com 2008
Miquel-Àngel Burgos i Fradeja
miquel.angel.burgos@gmail.com 2020

# Ús

Quan escriviu scripts, podeu utilitzar el Zenity per a crear diàlegs senzills que interactuen gràficament amb l'usuari com segueix:

Podeu crear un diàleg per a 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.

Podeu crear un diàleg per a proporcionar informació a l'usuari. Per exemple, podeu utilitzar un diàleg de progrés per a indicar l'estat actual d'una operació o utilitzar el diàleg de missatge d'avís per a alertar a l'usuari.

Quan l'usuari tanca el diàleg, el Zenity imprimeix el text produït pel diàleg a la sortida estàndard.

Quan escriviu ordres del Zenity, assegureu-vos de posar cometes al voltant de cada argument.

Per exemple, utilitzeu:

    zenity --calendar --title="Planificador de vacances"

No utilitzeu pas:

    zenity --calendar --title=Planificador de vacances

Si no utilitzeu les cometes no obtindreu els resultats esperats.

# Tecles d'accés

Una tecla d'accés és una tecla que us permet realitzar una acció des del teclat en lloc 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.

Alguns diàlegs del Zenity admeten l'ús de tecles d'accés. Per a especificar el caràcter a utilitzar com a tecla d'accés, col·loqueu un 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:

    «_Trieu un nom».

# Codis de sortida

El Zenity retorna els codis de sortida següents:

Codi de sortida | Descripció
--- | ---
0 | L'usuari ha premut D'acord o Tanca.
1 | L'usuari ha premut Cancel·la o ha utilitzat les funcions de la finestra per a tancar el diàleg.
-1 | S'ha produït un error inesperat.
5 | S'ha tancat el diàleg perquè s'ha acabat el temps d'espera.

# Opcions generals

Tots els diàlegs del Zenity admeten les opcions generals següents:

## --title=títol

Especifica el títol d'un diàleg.

## --window-icon=camí

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).

## --width=amplada

Especifica l'amplada del diàleg.

## --height=alçada

Especifica l'alçada del diàleg.

## --timeout=temps

Especifica el temps d'espera, en segons, passats els quals es tancarà el diàleg.

# Opcions d'ajuda

El Zenity proporciona les opcions d'ajuda següents:

## --help

Mostra el text d'ajuda abreviat.

## --help-all

Mostra el text d'ajuda complet per tots els diàlegs.

## --help-general

Mostra el text d'ajuda de les opcions generals dels diàlegs.

## --help-calendar

Mostra el text d'ajuda de les opcions del diàleg de calendari.

## --help-entry

Mostra el text d'ajuda de les opcions del diàleg d'entrada de text.

## --help-error

Mostra el text d'ajuda de les opcions del diàleg d'error.

## --help-info

Mostra el text d'ajuda de les opcions del diàleg informatiu.

## --help-file-selection

Mostra el text d'ajuda de les opcions del diàleg de selecció de fitxers.

## --help-list

Mostra el text d'ajuda de les opcions del diàleg de llista.

## --help-notification

Mostra el text d'ajuda de les opcions de la icona de notificació.

## --help-progress

Mostra el text d'ajuda de les opcions del diàleg de progrés.

## --help-question

Mostra el text d'ajuda de les opcions del diàleg de pregunta.

## --help-warning

Mostra el text d'ajuda de les opcions del diàleg d'avís.

## --help-text-info

Mostra l'ajuda de les opcions del diàleg de text informatiu.

## --help-misc

Mostra l'ajuda de les opcions miscel·lànies.

## --help-gtk

Mostra l'ajuda de les opcions de la GTK+.

# Opcions miscel·lànies

El Zenity també proporciona les opcions diverses següents:

## --about

Mostra el diàleg Quant al Zenity, que conté informació de la versió, del copyright i de desenvolupament del Zenity.

## --version

Mostra el número de versió del Zenity.

# Opcions de la GTK+

El Zenity admet les opcions estàndard de la GTK+. Per a obtenir més informació sobre les opcions de la GTK+, executeu l'ordre zenity --help-gtk.

# Variables d'entorn

Normalment, el Zenity detecta la finestra del terminal des d'on s'ha executat i es manté sobre aquesta finestra. Aquest comportament es pot desactivar inhabilitant la variable d'entorn WINDOWID.