Puede usar Zenity para crear diálogos simples que interactúen gráficamente con el usuario.
Daniel Mustieles
daniel.mustieles@gmail.com 2012-2014
Jorge González
jorgegonz@svn.gnome.org 2007-2010
Alejandro Aravena
raidenblast@gmail.com 2005
QA: Francisco Javier F. Serrador
serrador@cvs.gnome.org 2005

# Uso

Cuando escriba scripts, puede usar Zenity para crear diálogos simples que interactúen gráficamente con el usuario, como por ejemplo:

Puede crear un diálogo para obtener información del usuario. Por ejemplo, puede pedir al usuario seleccionar una fecha de un diálogo del calendario, o seleccionar un archivo de un diálogo de selección de archivo.

Usted puede crear un diálogo para proporcionar información al usuario. Por ejemplo, puede usar un diálogo de progreso para indicar el estado actual de una operación, o usar un diálogo de advertencia para alertar al usuario.

Cuando el usuario cierra el diálogo, Zenity imprime el texto producido por diálogo a la salida estándar de error.

Cuando usted escriba comandos de Zenity, asegúrese de poner comillas alrededor de cada argumento.

Por ejemplo, use:

    zenity --calendar --title="Calendario de vacaciones"

No use:

    zenity --calendar --title=Calendario de vacaciones

Si no usa comillas, puede que consiga resultados inesperados.

# Atajos del teclado

Un atajo del teclado le permite realizar una acción desde el teclado en lugar de utilizar el ratón para elegir un comando de un menú o un diálogo. Cada atajo del teclado se identifica por una letra subrayada en una opción del menú o de un diálogo.

Algunos diálogos de Zenity soportan el uso de atajos del teclado. Para especificar el carácter que se utilizará como atajo del teclado, ponga un guión bajo precediendo ese carácter en el texto del diálogo. El siguiente ejemplo muestra cómo especificar la letra «E» como atajo del teclado:

    «_Elija un nombre».

# Códigos de salida

Zenity devuelve los siguientes códigos de salida:

Código de salida | Descripción
--- | ---
0 | El usuario ha pulsado Aceptar o Cerrar.
1 | El usuario ha presionado Cancelar, o ha usado la función de la ventana para cerrar el diálogo.
-1 | Ha ocurrido un error inesperado.
5 | El diálogo se ha cerrado porque se alcanzó el tiempo de expiración.

# Opciones generales

Todos los diálogos de Zenity soportan las siguientes opciones generales:

## --title=título

Especifica el título de un diálogo.

## --window-icon=ruta_al_icono

Especifica el icono que se muestra en el marco de la ventana del diálogo. Hay 4 iconos disponibles, proporcionando las palabras claves siguientes - 'info', 'warning', 'question' y 'error'.

## --width=anchura

Especifica el ancho del diálogo.

## --height=altura

Especifica la altura del diálogo.

## --timeout=tiempo_de_expiración

Especifica el tiempo de expiración en segundos después del cual el diálogo se cierra.

# Opciones de ayuda

Zenity proporciona las siguientes opciones de ayuda:

## --help

Muestra un texto de ayuda abreviado.

## --help-all

Muestra un texto de ayuda completo para todos los diálogos.

## --help-general

Muestra el texto de ayuda para los opciones de diálogo generales.

## --help-calendar

Muestra el texto de ayuda para las opciones de diálogo del calendario.

## --help-entry

Muestra el texto de ayuda para las opciones del diálogo de entrada de texto.

## --help-error

Muestra el texto de ayuda para las opciones del diálogo de error.

## --help-info

Muestra el texto de ayuda para las opciones del diálogo de información.

## --help-file-selection

Muestra el texto de ayuda para las opciones del diálogo de selección de archivos.

## --help-list

Muestra el texto de ayuda para las opciones del diálogo de lista.

## --help-notification

Muestra el texto de ayuda para las opciones de iconos de notificación.

## --help-progress

Muestra el texto de ayuda para las opciones del diálogo de progreso.

## --help-question

Muestra el texto de ayuda para las opciones del diálogo de pregunta.

## --help-warning

Muestra el texto de ayuda para las opciones del diálogo de advertencia.

## --help-text-info

Muestra el texto de ayuda para las opciones del diálogo de información.

## --help-misc

Muestra el texto de ayuda para las opciones misceláneas.

## --help-gtk

Muestra la ayuda para las opciones de GTK+.

# Opciones misceláneas

Zenity también proporciona las siguientes opciones varias:

## --about

Muestra el diálogo Acerca de Zenity, que contiene la información de la versión de Zenity, información del copyright, e información del desarrollador.

## --version

Muestra el número de versión de Zenity.

# Opciones de GTK+

Zenity soporta las opciones estándares de GTK+. Para obtener más información acerca de las opciones de GTK+, ejecute el comando zenity --help-gtk.

# Variables de entorno

Generalmente Zenity detecta la ventana del terminal desde la que se ha lanzado y se mantiene por encima de esa ventana. Este comportamiento se puede desactivar con la variable de entorno `WINDOWID`.