Uso

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.

Combinaciones de teclas

Una combinación de teclas 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 combinación de teclas 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 combinaciones de teclas. Para especificar el carácter que se utilizará como combinación de teclas, 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 combinación de teclas:

«_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:

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

Especifica el título de un diálogo.

<cmd>--window-icon</cmd>=<var>ruta_al_icono</var>

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

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

Especifica el ancho del diálogo.

<cmd>--height</cmd>=<var>altura</var>

Especifica la altura del diálogo.

<cmd>--timeout</cmd>=<var>tiempo_de_expiración</var>

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:

Muestra un texto de ayuda abreviado.

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

<cmd>--help-general</cmd>

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

<cmd>--help-calendar</cmd>

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

<cmd>--help-entry</cmd>

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

<cmd>--help-error</cmd>

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

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

<cmd>--help-file-selection</cmd>

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

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

<cmd>--help-notification</cmd>

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

<cmd>--help-progress</cmd>

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

<cmd>--help-question</cmd>

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

<cmd>--help-warning</cmd>

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

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

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

Muestra la ayuda para las opciones de GTK+.

Opciones misceláneas

Zenity también proporciona las siguientes opciones varias:

<cmd>--about</cmd>

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.

<cmd>--version</cmd>

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.