Ús

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:

<cmd>--title</cmd>=<var>títol</var>

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

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

Especifica l'amplada del diàleg.

<cmd>--height</cmd>=<var>alçada</var>

Especifica l'alçada del diàleg.

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

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:

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

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

<cmd>--about</cmd>

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

<cmd>--version</cmd>

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.