You can use Zenity to create simple dialogs that interact graphically with the user.

# Modo de uso

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

Você pode criar um diálogo para obter informações do usuáro. Por exemplo, você pedir ao usuário que selecione uma data em um diálogode calendário ou para escolher um arquivo por um diálogo de seleção de arquivo.

Você pode criar um diálogo para prover informações ao usuário. Por exemplo, você pode usar um diálogo indicador de progresso para indicar o estado atual de uma operação ou usar um diálogo de mensagem de aviso para alertar o usuário.

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

Se você não utilizar as aspas, pode obter resultados inesperados.

# Teclas de acesso

Uma tecla de acesso é aquela que lhe habilita desempenhar uma ação a partir do teclado, em vez de usar o mouse, para escolher um comando de um menu ou de um diálogo. Cada tecla de acesso é identificada por uma letra sublinhada em uma opção do menu ou do diálogo.

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:

    "_Choose a name".

# Códigos de saída

Zenity returns the following exit codes:

Código de saída | Descrição
--- | ---
0 | The user has pressed either OK or Close.
1 | The user has either pressed Cancel, or used the window functions to close the dialog.
-1 | Ocorreu um erro inesperado.
5 | O diálogo foi fechado porque o tempo de espera se esgotou.

# Opções gerais

All Zenity dialogs support the following general options:

## --title=title

Especifica o título de um diálogo.

## --window-icon=icon_path

Especifica o ícone que é exibido na moldura do diálogo. Existem 4 ícones pré-definidos que também estão disponíveis ao usar as seguintes palavras-chave - "info", "warning" (aviso), "question" (pergunta) e "error" (erro).

## --width=width

Especifica a largura do diálogo.

## --height=height

Especifica a altura do diálogo.

## --timeout=timeout

Especifica o tempo de espera em segundos depois do qual o diálogo será fechado.

# Opções de ajuda

Zenity provides the following help options:

## --help

Exibe o texto resumido de ajuda.

## --help-all

Exibe o texto completo de ajuda para todos os diálogos.

## --help-general

Exibe os textos de ajuda para opções gerais de diálogos.

## --help-calendar

Exibe o texto de ajuda para as opções do diálogo de calendário.

## --help-entry

Exibe o texto de ajuda para as opções do diálogo de entrada de texto.

## --help-error

Exibe o texto de ajuda para as opções do diálogo de erro.

## --help-info

Exibe o texto de ajuda para as opções do diálogo de informação.

## --help-file-selection

Exibe o texto de ajuda para as opções do diálogo de seleção de arquivo.

## --help-list

Exibe o texto de ajuda para as opções do diálogo de lista.

## --help-notification

Exibe o texto de ajuda para as opções de ícones de notificação.

## --help-progress

Exibe o texto de ajuda para as opções do diálogo indicador de progresso.

## --help-question

Exibe o texto de ajuda para as opções do diálogo de pergunta.

## --help-warning

Exibe o texto de ajuda para as opções do diálogo de aviso.

## --help-text-info

Exibe o texto de ajuda para as opções do diálogo de informação de texto.

## --help-misc

Exibe o texto de ajuda para outras opções.

## --help-gtk

Exibe ajuda para as opções do GTK+.

# Outras opções

Zenity also provides the following miscellaneous options:

## --about

Displays the About Zenity dialog, which contains Zenity version information, copyright information, and developer information.

## --version

Displays the version number of Zenity.

# Opções do GTK+

Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity --help-gtk command.

# Variáveis de ambiente

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.