Podeu utilitzar el Zenity per a crear diàlegs senzills que interactuen gràficament amb l'usuari.

This work is licensed under a GNU Free Documentation License Version 1.1 or any later version.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link.

Aquest manual forma part d'una col·lecció de manuals del GNOME distribuïts sota la GFDL. Si voleu distribuir aquest manual independentment de la col·lecció, podeu fer-ho afegint una còpia de la llicència al manual, tal com es descriu a la secció 6 de la llicència.

Molts dels noms que les empreses utilitzen per a distingir els seus productes i serveis es consideren marques comercials. Quan aquests noms apareguin en qualsevol documentació del GNOME, si els membres del Projecte de documentació del GNOME han estat avisats pel que fa a les marques, els noms apareixeran en majúscules o amb les inicials en majúscules.

EL DOCUMENT I LES VERSIONS MODIFICADES DEL DOCUMENT ES FACILITEN SOTA ELS TERMES DE LA LLICÈNCIA DE DOCUMENTACIÓ LLIURE DE GNU, TENINT EN COMPTE QUE:

EL DOCUMENT S'OFEREIX «TAL COM ÉS», SENSE CAP TIPUS DE GARANTIA, NI EXPLÍCITA NI IMPLÍCITA; AIXÒ INCLOU, SENSE LIMITAR-S'HI, LES GARANTIES QUE EL DOCUMENT O LA VERSIÓ MODIFICADA DEL DOCUMENT NO TINGUI DEFECTES, SIGUI COMERCIALITZABLE, SIGUI ADEQUAT PER A UN ÚS CONCRET O NO INFRINGEIXI CAP LLEI. TOT EL RISC PEL QUE FA A LA QUALITAT, EXACTITUD I RENDIMENT DEL DOCUMENT O LA VERSIÓ MODIFICADA DEL DOCUMENT ÉS VOSTRE. EN CAS QUE EL DOCUMENT RESULTÉS DEFECTUÓS EN QUALSEVOL ASPECTE, VÓS (NO PAS L'ESCRIPTOR INICIAL, L'AUTOR O CAP ALTRE COL·LABORADOR) ASSUMIU TOT EL COST DE MANTENIMENT, REPARACIÓ O CORRECCIÓ. AQUESTA RENÚNCIA DE GARANTIA CONSTITUEIX UNA PART ESSENCIAL D'AQUESTA LLICÈNCIA. NO S'AUTORITZA L'ÚS DE CAP DOCUMENT O VERSIÓ MODIFICADA DEL DOCUMENT EXCEPTE SOTA AQUESTA RENÚNCIA DE GARANTIA; I

EN CAP CAS I SOTA CAP INTERPRETACIÓ LEGAL, JA SIGUI PER AGREUJAMENT (INCLOENT-HI LA NEGLIGÈNCIA), CONTRACTE O ALTRE CAS, L'AUTOR, L'ESCRIPTOR ORIGINAL, QUALSEVOL DELS COL·LABORADORS O DISTRIBUÏDORS DEL DOCUMENT O UNA VERSIÓ MODIFICADA DEL DOCUMENT NI CAP PROVEÏDOR D'AQUESTES PARTS NO SERAN RESPONSABLES DAVANT DE NINGÚ PER CAP DANY DIRECTE, INDIRECTE, ESPECIAL, ACCIDENTAL O CONSECUTIU DE QUALSEVOL TIPUS; AIXÒ INCLOU, SENSE LIMITAR-S'HI, ELS DANYS PER PÈRDUA DE CLIENTS, INTERRUPCIONS DE LA FEINA, FALLADA O MALFUNCIONAMENT DE L'ORDINADOR, O QUALSEVOL ALTRA PÈRDUA O DANY RELACIONAT AMB L'ÚS DEL DOCUMENT I LES VERSIONS MODIFICADES DEL DOCUMENT, FINS I TOT SI S'HA INFORMAT AQUESTA PART DE LA POSSIBILITAT D'AQUESTS DANYS.

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:

## --title=títol

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

## --width=amplada

Especifica l'amplada del diàleg.

## --height=alçada

Especifica l'alçada del diàleg.

## --timeout=temps

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:

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

El Zenity també proporciona les opcions diverses 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.

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