Uso

When you write scripts, you can use Zenity to create simple dialogs that interact graphically with the user, as follows:

  • You can create a dialog to obtain information from the user. For example, you can prompt the user to select a date from a calendar dialog, or to select a file from a file selection dialog.
  • You can create a dialog to provide the user with information. For example, you can use a progress dialog to indicate the current status of an operation, or use a warning message dialog to alert the user.

When the user closes the dialog, Zenity prints the text produced by the dialog to standard output.

When you write Zenity commands, ensure that you place quotation marks around each argument.

For example, use:

zenity --calendar --title="Holiday Planner"
Do not use:
zenity --calendar --title=Holiday Planner

If you do not use quotation marks, you might get unexpected results.

2.1. Combinacións de teclas

An access key is a key that enables you to perform an action from the keyboard rather than use the mouse to choose a command from a menu or dialog. Each access key is identified by an underlined letter on a menu or dialog option.

Some Zenity dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:

"_Seleccione un nome".

2.2. Códigos de saída

Zenity retorna os seguintes códigos de erro:

Código de saída Descrición
0 O usuario premeu ou Aceptar ou Pechar.
1 O usuario premeu ou Cancelar ou usou as funcións de xanela para pechar o diálogo.
-1 Produciuse un erro inesperado.
5 O diálogo pechouse porque o tempo de espera alcanzouse.

2.3. Opcións xerais

Tódolos diálogos de Zenity son compatíbeis coas seguintes opcións xerais:

--title=título

Especifica o título dun diálogo.

--window-icon=ruta_de_icona

Especifica a icona que se mostra no marco da xanela do diálogo. Hai 4 iconas dispoñíbeis, fornecendo as palabras chave seguintes - «info», «warning», «question» e «erro».

--width=ancho

Especifica o ancho dun diálogo

--height=alto

Especifica o alto dun diálogo

--timeout=tempo de espera

Especifica o tempo de espera en segundos despois do cal o diálogo se pechará.

2.4. Opcións de axuda

Zenity fornece as seguintes opcións de axuda

--help

Mostra un texto de axuda abreviado.

--help-all

Mostra o texto de axuda para os diálogos

--help-general

Mostra o texto de axuda para as opcións de diálogo xerais.

--help-calendar

Mostra o texto de axuda para as opcións do diálogo do calendario.

--help-entry

Mostra o texto de axuda para as opcións do diálogo de entrada de texto.

--help-error

Mostra o texto de axuda para as opcións do diálogo de erro.

--help-info

Mostra o texto de axuda para as opcións do diálogo de información.

--help-file-selection

Mostra o texto de axuda para as opcións do diálogo de selección de ficheiros.

--help-list

Mostra o texto de axuda para as opcións do diálogo de lista.

--help-notification

Mostra o texto de axuda para as opcións de iconas de notificación.

--help-progress

Mostra o texto de axuda para as opcións do diálogo de progreso.

--help-question

Mostra o texto de axuda para as opcións do diálogo de pregunta.

--help-warning

Mostra o texto de axuda para as opcións do diálogo de avisos.

--help-text-info

Mostra o texto de axuda para as opcións de diálogo de información.

--help-misc

Mostra axuda para opcións varias.

--help-gtk

Mostra axuda para as opcóns de GTK+

2.5. Opcións varias

Zenity tamén fornece as seguintes opcións varias:

--about

Mostra o diálogo Sobre Zenity, que contén información da versión de Zenity, información de copyright e información do desenvolvedor.

--version

Mostra o número de versión de Zenity.

2.6. Opcións de GTK+

Zenity admite as opcións GTK+ estándar. Para obter máis información sobre as opcións de GTK+, execute a orde zenity -?.

2.7. Variábeis de contorno

Normally, Zenity detects the terminal window from which it was launched and keeps itself above that window. This behavior can be disabled by unsetting the WINDOWID environment variable.