zenity(1)							   User Commands							 zenity(1)

NAME

       zenity, gdialog - display simple GNOME dialogs

SYNOPSIS

       zenity  --calendar  [--title=title] [--window-icon=path] [--width=width] [--height=height] [--timeout=seconds] [--text=text] [--day=number]
       [--month=number] [--year=number] [--date-format=format]

       zenity --entry [--title=title] [--window-icon=path] [--width=width] [--height=height] [--timeout=seconds] [--text=text] [--entry-text=text]
       [--hide-text]

       zenity --error | --info | --question | --warning [--title=title] [--window-icon=path] [--width=width] [--height=height] [--timeout=seconds]
       [--text=text] [--nowrap]

       zenity  --file-selection  [--title=title]  [--window-icon=path]	[--width=width]  [--height=height]  [--timeout=seconds]  [--filename=path]
       [--multiple] [--directory] [--save] [--separator=character] [--confirm-overwrite]

       zenity  --list  [--title=title]	[--window-icon=path]  [--width=width]  [--height=height]  [--timeout=seconds]  --column=text [--checklist]
       [--radiolist] [--separator=character] [--multiple] [--editable] [--print-column=number] [--hide-column=number]

       zenity --notification [--window-icon=path] [--timeout=seconds] [--text=text] [--listen]

       zenity --progress [--title=title] [--window-icon=path]  [--width=width]	[--height=height]  [--timeout=seconds]	[--text=text]  [--percent-
       age=number] [--pulsate] [--auto-close] [--auto-kill]

       zenity  --scale	[--title=title]  [--window-icon=path] [--width=width] [--height=height] [--timeout=seconds] [--text=text] [--value=number]
       [--min-value=number] [--max-value=number] [--step=number] [--print-partial] [--hide-value]

       zenity  --text-info  [--title=title]   [--window-icon=path]   [--width=width]   [--height=height]   [--timeout=seconds]	 [--filename=path]
       [--editable]

       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 Miscellaneous Options
       The following miscellaneous 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.

       --help-* 	       Display help text on specific dialogs.

   GTK+ Options
       Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity --help-gtk- 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.

       --notification	       Display a notification icon.

       --progress	       Display a progress indication dialog.

       --question	       Display a question dialog.

       --scale		       Display a scale dialog.

       --text-info	       Display a text information dialog.

       --warning	       Display a warning dialog.

   General Dialog Options
       The following general dialog options are supported:

       --title=title	       Set the dialog title.

       --window-icon=path      Set the dialog window icon with a full path to an image.

       --width=width	       Set the dialog width.

       --height=height	       Set the dialog height.

       --timeout=seconds       Set the dialog timeout in seconds.

   Calendar Dialog Options
       The following calendar dialog options are supported:

       --text=text	       Set the dialog text.

       --day=number	       Set the calendar day.

       --month=number	       Set the calendar month.

       --year=number	       Set the calendar year.

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

   Text-Entry Dialog Options
       The following text-entry dialog options are supported:

       --text=text	       Set the dialog text.

       --entry-text=text       Set the dialog entry text.

       --hide-text	       Use asterisks to hide the entry text.

   Error, Info, Question and Warning Dialog Options
       The following error, info, question and warning dialog options are supported:

       --text=text	       Set the dialog text.

       --nowrap 	       Do not enable text wrapping in the dialog.

   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.

       --directory	       Activate directory-only selection.

       --save		       Activate save mode file selection.

       --separator=character   Set the separator character to return at the command line.  This option is used only when the dialog allows  multi-
			       ple selections.

       --confirm-overwrite     Confirm overwrite of files.

   List Dialog Options
       The following list dialog options are supported:

       --text=text	       Set the dialog text.

       --column=text	       Set the text of a column.

       --checklist	       Specify that the first column contains check boxes.

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

       --editable	       Specify that the dialog contents are editable.

       --print-column=number   Specify which column to print on return.

       --hide-column=number    Specify which columns should be hidden from view.

   Notification Options
       The following notification dialog options are supported:

       --text=text	       Set the dialog text.

       --listen 	       Listen for commands on standard input. Commands include 'message', 'tooltip', 'icon', and 'visible' separated by  a
			       colon. For example, "message:Hello world", "icon:/path/to/icon", or "visible:false".

   Progress-Indication Dialog Options
       The following progress-indication dialog options are supported:

       --text=text	       Set the dialog text.

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

       --auto-close	       Close the dialog automatically when 100% has been reached.

       --auto-kill	       Kill the parent process if cancel button is pressed.

   Scale Dialog Options
       The following scale dialog options are supported:

       --text=text	       Set the dialog text.

       --value=number	       Set the initial value.

       --min-value=number      Set the minimum value of the scale.

       --max-value=number      Set the maximum value of the scale.

       --step=number	       Set the step size of the scale.

       --print-partial	       Set the values of the scale as they are selected.

       --hide-value	       Set the value of the scale from view.

   Text-Informational Dialog Options
       The following text-informational dialog options are supported:

       --filename=path	       Set the file to display in the dialog.

       --editable	       Specify that the dialog contents are editable.

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="OpenSolaris License" 
	 --filename="/usr/src/OPENSOLARIS.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		     |SUNWgnome-dialog		   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Volitile			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       Zenity Manual

       Latest version of the GNOME Desktop User Guide for your platform.

       attributes(5), environ(5), gnome-std-options(5)

NOTES

       Written by Glynn Foster, Sun Microsystems Inc., 2003, 2004, 2006, 2007.

SunOS 5.11							    15 Nov 2007 							 zenity(1)