Utilització

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:

<cmd>--title</cmd>=<var>title</var>

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

<cmd>--window-icon</cmd>=<var>icon_path</var>

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

<cmd>--width</cmd>=<var>width</var>

Especifica l'amplada del diàleg.

<cmd>--height</cmd>=<var>height</var>

Especifica l'alçada del diàleg.

<cmd>--timeout</cmd>=<var>timeout</var>

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

Opcions d'ajuda

Zenity provides the following help options:

Mostra el text d'ajuda abreviat.

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

<cmd>--help-general</cmd>

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

<cmd>--help-calendar</cmd>

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

<cmd>--help-entry</cmd>

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

<cmd>--help-error</cmd>

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

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

<cmd>--help-file-selection</cmd>

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

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

<cmd>--help-notification</cmd>

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

<cmd>--help-progress</cmd>

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

<cmd>--help-question</cmd>

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

<cmd>--help-warning</cmd>

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

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

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

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

Opcions miscel·lànies

Zenity also provides the following miscellaneous options:

<cmd>--about</cmd>

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

<cmd>--version</cmd>

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.