É possível usar o Zenity para criar diálogos simples que interajam graficamente com o usuário.
Rodolfo Ribeiro Gomes
rodolforg@gmail.com 2009
Rafael Fontenelle
rafaelff@gnome.org 2017

# Modo de uso

Quando se escreve scripts, é possível usar o Zenity para criar diálogos simples que interajam graficamente com o usuário:

Você pode criar um diálogo para obter informações do usuário. Por exemplo, você pedir ao usuário que selecione uma data em um diálogo de 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.

Quando o usuário fecha um diálogo, o Zenity emite o texto produzido por ele para a saída padrão.

Ao escrever os comandos do Zenity, assegure-se de fazer uso das aspas em volta de cada argumento.

Por exemplo, use:

    zenity --calendar --title="Planejamento do feriado"

Não use:

    zenity --calendar --title=Planejamento do feriado

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.

Alguns diálogos do Zenity oferecem suporte para o uso de teclas de acesso. Para especificar o caractere a usar como tecla de acesso, coloque um sublinhado antes de tal caractere no texto do diálogo. Os exemplos a seguir mostram como especificar a letra “E” como tecla de acesso:

    “_Escolha um nome”.

# Códigos de saída

O Zenity retorna os seguintes códigos de saída:

Código de saída | Descrição
--- | ---
0 | O usuário pressionou ou OK ou Fechar.
1 | O usuário ou pressionou Cancelar ou usou as funções da janela para fechar o diálogo.
-1 | Ocorreu um erro inesperado.
5 | O diálogo foi fechado porque o tempo de espera se esgotou.

# Opções gerais

Todos os diálogos do Zenity oferecem suporte às seguintes opções gerais:

## --title=título

Especifica o título de um diálogo.

## --window-icon=caminho_ícone

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” (informação), “warning” (aviso), “question” (pergunta) e “error” (erro).

## --width=largura

Especifica a largura do diálogo.

## --height=altura

Especifica a altura do diálogo.

## --timeout=tempo

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

# Opções de ajuda

O Zenity fornece as seguintes opções de ajuda:

## --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

O Zenity também fornece as seguintes opções adicionais:

## --about

Exibe o diálogo Sobre o zenity, que contém as informações da versão do Zenity, dos direitos autorais e dos desenvolvedores.

## --version

Exibe o número da versão do Zenity.

# Opções do GTK+

O Zenity oferece suporte às opções padrões do GTK+. Para mais informações sobre elas, execute o comando zenity --help-gtk.

# Variáveis de ambiente

Normalmente, o Zenity detecta a janela de terminal pela qual foi lançado e se mantém acima dessa janela. Esse comportamento pode ser desativado desconfigurando a variável de ambiente WINDOWID.