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"
zenity --calendar --title=Planificació de les vacances
Si no utilitzeu les cometes no obtindreu els resultats esperats.
- 2.1. Tecles d'accés
- 2.2. Codis de sortida
- 2.3. Opcions generals
- 2.4. Opcions d'ajuda
- 2.5. Opcions miscel·lànies
- 2.6. Opcions de la GTK+
- 2.7. Variables d'entorn
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 o . |
1 | L'usuari ha premut 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.