You can use Zenity to create simple dialogs that interact graphically with the user.

# Utilització

When you write scripts, you can use Zenity to create simple dialogs that interact graphically with the user, as follows:

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.

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.

When the user closes the dialog, Zenity prints the text produced by the dialog to standard output.

When you write Zenity commands, ensure that you place quotation marks around each argument.

For example, use:

    zenity --calendar --title="Holiday Planner"

Do not use:

    zenity --calendar --title=Holiday Planner

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

Some Zenity 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:

    "_Choose a name".

# Codis de sortida

Zenity returns the following exit codes:

Codi de sortida | Descripció
--- | ---
0 | The user has pressed either OK or Close.
1 | The user has either pressed Cancel, or used the window functions to close the dialog.
-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

All Zenity dialogs support the following general options:

## --title=title

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

## --window-icon=icon_path

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=width

Especifica l'amplada del diàleg.

## --height=height

Especifica l'alçada del diàleg.

## --timeout=timeout

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

# Opcions d'ajuda

Zenity provides the following help options:

## --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

Zenity also provides the following miscellaneous options:

## --about

Displays the About Zenity dialog, which contains Zenity version information, copyright information, and developer information.

## --version

Displays the version number of Zenity.

# Opcions de la GTK+

Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity --help-gtk command.

# Variables d'entorn

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 WINDOWID environment variable.