MAN Solaris - zenity (1)

advertisement


NAME

zenity, gdialog - display simple GNOME dialogs

CONTENTS

SYNOPSIS

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

advertisements

advertisements


DESCRIPTION

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.

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.

    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.

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

    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.

    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 TYPEATTRIBUTE VALUE
AvailabilitySUNWgnome-dialog
Interface stabilityVolitile

SEE ALSO

Zenity Manual

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

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

NOTES

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

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


SunOS 5.11 zenity (1) 20 Jul 2004
Generated by Open Solaris Forum from /usr/share/man/man1/zenity.1 using man macros with tbl support.