Modo de uso

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:

"_Escolha um nome".

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:

<cmd>--title</cmd>=<var>title</var>

Especifica o título de um diálogo.

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

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

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

Especifica a largura do diálogo.

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

Especifica a altura do diálogo.

<cmd>--timeout</cmd>=<var>timeout</var>

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:

Exibe o texto resumido de ajuda.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Outras opções

Zenity also provides the following miscellaneous options:

<cmd>--about</cmd>

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

<cmd>--version</cmd>

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.