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

# 用法

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

您可以创建从用户那儿获得信息的对话框。例如，您可以提示用户从日历对话框中选择日期，或者从文件选择框里选择一个文件。

您可以创建向用户提供信息的对话框。例如，您可以用进度条来显示一个操作的当前运行状态，或者用一个警告框提醒用户。

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

如果您没有使用双引号，可能会产生不可预料的结果。

# 访问键

访问键允许您用键盘来执行一个操作，而不是用鼠标点击菜单命令或对话框按钮。每个访问键有一个标识符，是一个在菜单或对话框选项上的带下划线的字母。

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

# 退出代码

Zenity returns the following exit codes:

退出代码 | 描述
--- | ---
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 | 发生了一个有异常。
5 | 对话框因超时而关闭。

# 常规选项

All Zenity dialogs support the following general options:

## --title=title

指定对话框的标题。

## --window-icon=icon_path

指定显示在窗口框架上的图标，有四个图标也可以用下列关键字 - 'info'， 'warning'， 'question' 和 'error'。

## --width=width

指定对话框的宽度。

## --height=height

指定对话框的高度。

## --timeout=timeout

指定超出时间(秒)后对话框自动关闭。

# 帮助选项

Zenity provides the following help options:

## --help

显示简短的帮助文本。

## --help-all

显示所有对话框的完整帮助。

## --help-general

显示常规对话框选项的帮助文本。

## --help-calendar

显示日历对话框选项的帮助文本。

## --help-entry

显示文本输入框选项的帮助文本。

## --help-error

显示错误框选项的帮助文本。

## --help-info

显示信息框选项的帮助文本。

## --help-file-selection

显示文件打开框选项的帮助文本。

## --help-list

显示列表框选项的帮助文本。

## --help-notification

显示提示框选项的帮助文本。

## --help-progress

显示进度框选项的帮助文本。

## --help-question

显示询问框选项的帮助文本。

## --help-warning

显示警告框选项的帮助文本。

## --help-text-info

显示信息框选项的帮助文本。

## --help-misc

显示其他杂项的帮助文本。

## --help-gtk

显示 GTK+ 选项的帮助文本。

# 杂项

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.

# GTK+ 选项

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

# 环境变量

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.