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"
zenity --calendar --title=Holiday Planner
If you do not use quotation marks, you might get unexpected results.
- 2.1. Combinacións de teclas
- 2.2. Códigos de saída
- 2.3. Opcións xerais
- 2.4. Opcións de axuda
- 2.5. Opcións varias
- 2.6. Opcións de GTK+
- 2.7. Variábeis de contorno
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 ou . |
1 | O usuario premeu ou 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.