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)