Utilització

Quan escriviu scripts, podeu utilitzar el Zenity per crear diàlegs senzills que interactuen gràficament amb l'usuari. Funciona així:

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

Qual 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 que poseu cometes al voltant de cada argument.

Per exemple, utilitzeu:

zenity --calendar --title="Planificació de les vacances"
No utilitzeu:
zenity --calendar --title=Planificació de les vacances

Si no utilitzeu les cometes no obtindreu els resultats esperats.

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

Alguns diàlegs del Zenity 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:

«_Trieu un nom».

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

2.3. 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=ruta_de_la_icona

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 d'espera

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

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

2.5. Opcions miscel·lànies

El Zenity també proporciona les opcions misel·lànies 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.

2.6. Opcions de la GTK+

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

2.7. Variables d'entorn

Normalment el Zenity 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 WINDOWID.