---

MAN Solaris - zenity (1)

---

zenity, gdialog - display simple GNOME dialogs

CONTENTS

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

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

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

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

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

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

zenity --progress [--title=title] [--window-icon=path] [--width=width] [--height=height] [--text=text] [--percentage=number] [--pulsate] [--auto-close]

zenity --scale [--title=title] [--window-icon=path] [--width=width] [--height=height] [--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] [--filename=path] [--editable]

zenity --about | - -help | --usage | --version | - GTK+_options

The Zenity application displays simple GNOME dialogs. You can use Zenity to create scripts that interact graphically with the user. gdialog(1) has been deprecated and is now a wrapper script around Zenity, and will preserve compatibility with older scripts.

Zenity supports several different types of 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.

The following help options are supported:

-?, --help Display help text.

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

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

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.

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.

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.

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.

The following error, info, question and warning dialog options are supported:

--text=text Set the dialog text.

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

--confirm-overwrite Confirm overwrite of files.

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

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

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.

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.

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.

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"

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.

The following exit values are returned:

-1
Error

0 OK

1 Cancel, Escape

The following files are used by this application:

/usr/bin/zenity Executable for Zenity.

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWgnome-dialog
Interface stability	Volitile

Zenity Manual

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

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

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

Jump to page    or go to Top of page |  Section 1 |  Main Solaris Index.