zenity(1)							   User Commands							 zenity(1)

NAME
zenity, gdialog - display simple GNOME dialogs SYNOPSIS
zenity --calendar [--height=height] [--title=title] [--width=width] [--window-icon=path] [--date-format=format] [--day=number] [--month=number] [--text=text] [--year=number] zenity --entry [--height=height] [--title=title] [--width=width] [--window-icon=path] [--entry-text=text] [--hide-text] [--text=text] zenity --error | --info | --question | --warning [--height=height] [--title=title] [--width=width] [--window-icon=path] [--text=text] zenity --file-selection [--height=height] [--title=title] [--width=width] [--window-icon=path] [--filename=path] [--multiple] [--separa- tor=character] zenity --list --column=text [--height=height] [--title=title] [--width=width] [--window-icon=path] [--checklist] [--editable] [--radiolist] [--separator=character] zenity --progress [--height=height] [--title=title] [--width=width] [--window-icon=path] [--auto-close] [--percentage=number] [--pulsate] [--text=text] zenity --text-info [--height=height] [--title=title] [--width=width] [--window-icon=path] [--editable] [--filename=path] zenity --about | --help | --usage | --version | -GTK+_options DESCRIPTION
The Zenity application displays simple GNOME dialogs. You can use Zenity to create scripts that interact graphically with the user. gdia- log(1) has been deprecated and is now a wrapper script around Zenity, and will preserve compatibility with older scripts. OPTIONS
Zenity supports several different types of options. Zenity-Specific Options The following Zenity-specific options are supported: --about Display the About Zenity dialog, which provides information about the Zenity application, including the version number and the author. --version Display the version number of Zenity. Help Options The following help options are supported: --help Display help text. You can also use -? to specify this option. --usage Display brief usage text. GTK+ Options Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity -? command. Dialog Options The following dialog options are supported: --calendar Display a calendar dialog. --entry Display a text entry dialog. --error Display an error dialog. --file-selection Display a file-selection dialog. --info Display an informational dialog. --list Display a list dialog. --progress Display a progress indication dialog. --question Display a question dialog. --text-info Display a text information dialog. --warning Display a warning dialog. General Dialog Options The following general dialog options are supported: --height=height Set the dialog height. --title=title Set the dialog title. --width=width Set the dialog width. --window-icon=path Set the dialog window icon with a full path to an image. Calendar Dialog Options The following calendar dialog options are supported: --date-format=format Set the date format to return at the command line. The default format depends on your locale. The format must be of strftime style, for example %A %d/%m/%y. --day=number Set the calendar day. --month=number Set the calendar month. --text=text Set the dialog text. --year=number Set the calendar year. Text-Entry Dialog Options The following text-entry dialog options are supported: --entry-text=text Set the dialog entry text. --hide-text Use asterisks to hide the entry text. --text=text Set the dialog text. Error Dialog Options The following error dialog options are supported: --text=text Set the dialog text. File-Selection Dialog Options The following file-selection dialog options are supported: --filename=path Set the file or directory to select by default. --multiple Allow multiple selections. --separator=character Set the separator character to return at the command line. This option is used only when the dialog allows multi- ple selections. Informational Dialog Options The following informational dialog options are supported: --text=text Set the dialog text. List Dialog Options The following list dialog options are supported: --checklist Specify that the first column contains check boxes. --column=text Set the text of a column. --editable Specify that the dialog contents are editable. --radiolist Specify that the first column contains radio buttons. --separator=character Set the separator character to return at the command line. This option is used only when the dialog allows multi- ple selections. Progress-Indication Dialog Options The following progress-indication dialog options are supported: --auto-close Close the dialog automatically when 100% has been reached. --percentage=number Set the initial percentage of the progress bar. --pulsate Specify that the progress bar pulsates until an EOF character is read from the command line. --text=text Set the dialog text. Question Dialog Options The following question dialog options are supported: --text=text Set the dialog text. Text-Informational Dialog Options The following text-informational dialog options are supported: --editable Specify that the dialog contents are editable. --filename=path Set the file to display in the dialog. Warning Dialog Options The following warning dialog options are supported: --text=text Set the dialog text. EXAMPLES
Example 1: Launching Zenity Using the List Dialog example% zenity --list --title="Choose bugs you wish to view" --text="Select items from the list below." --column="Bug Number" --column="Severity" --column="Description" 992383 Normal "GtkTreeView crashes on multiple selections" 293823 High "GNOME Dictionary does not handle proxy" 393823 Critical "Menu editing does not work in GNOME 2.0" Example 2: Launching Zenity Using the Progress Dialog example% find . -name '*.bk' | zenity --progress --title="Finding backups" --pulsate Example 3: Launching Zenity Using the Text Informational Dialog example% zenity --text-info --title="LGPL License" --filename="/home/user1/LICENSE" ENVIRONMENT VARIABLES
The following environment variables affect the execution of zenity: ZENITY_OK, DIALOG_OK Set the return value for OK. ZENITY_CANCEL, DIALOG_CANCEL Set the return value for Cancel. ZENITY_ERROR, DIALOG_ERROR Set the return value for Error. ZENITY_ESC, DIALOG_ESC Set the return value for Escape. EXIT STATUS
The following exit values are returned: -1 Error 0 OK 1 Cancel, Escape FILES
The following files are used by this application: /usr/bin/zenity Executable for Zenity. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWzenity | +-----------------------------+-----------------------------+ |Interface stability |External | +-----------------------------+-----------------------------+ SEE ALSO
Zenity Manual Latest version of the GNOME Desktop User Guide for your platform. NOTES
Written by Glynn Foster, Sun Microsystems Inc., 2003, 2004. SunOS 5.10 20 Jul 2004 zenity(1)