Query: zenity
OS: php
Section: 1
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
zenity(1) User Commands zenity(1)NAMEzenity, gdialog - display simple GNOME dialogsSYNOPSISzenity --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+_optionsDESCRIPTIONThe 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.OPTIONSZenity 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.EXAMPLESExample 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 VARIABLESThe 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 STATUSThe following exit values are returned: -1 Error 0 OK 1 Cancel, EscapeFILESThe following files are used by this application: /usr/bin/zenity Executable for Zenity.ATTRIBUTESSee attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWzenity | +-----------------------------+-----------------------------+ |Interface stability |External | +-----------------------------+-----------------------------+SEE ALSOZenity Manual Latest version of the GNOME Desktop User Guide for your platform.NOTESWritten by Glynn Foster, Sun Microsystems Inc., 2003, 2004. SunOS 5.10 20 Jul 2004 zenity(1)