GNU/Linux |
CentOS 5.5 |
|
![]() |
zenity(1) |
![]() |
zenity − display GTK+ dialogs
zenity [options]
zenity is a program that will display GTK+ dialogs, and return (either in the return code, or on standard output) the users input. This allows you to present information, and ask for information from the user, from all manner of shell scripts.
For example, zenity −−question will return either 0 or 1, depending on whether the user pressed OK or Cancel. zenity --entry will output on standard output what the user typed into the text entry field.
Comprehensive documentation is available in the GNOME Help Browser, under GNOME/Utilities.
This program follows the usual GNU command line syntax, with long options starting with two dashes (’-’).
Dialog options
−−calendar
Display calendar dialog
−−entry
Display text entry dialog
−−error
Display error dialog
−−file-selection
Display file selection dialog
−−info |
Display info dialog |
|||
−−list |
Display list dialog |
−−notification
Display notification icon
−−progress
Display progress indication dialog
−−question
Display question dialog
−−text-info
Display text information dialog
−−warning
Display warning dialog
General options
−−title=TITLE
Set the dialog title
−−window-icon=ICONPATH
Set the window icon
−−width=WIDTH
Set the dialog width
−−height=HEIGHT
Set the dialog height
Calendar
options
−−text=STRING
Set the dialog text
−−day=INT
Set the calendar day
−−month=INT
Set the calendar month
−−year=INT
Set the calendar year
−−date-format=STRING
Set the format for the returned date
Text entry
options
−−text=STRING
Set the dialog text
−−entry-text=STRING
Set the entry text
−−hide-text
Hide the entry text
Error options
−−text=STRING
Set the dialog text
File selection
options
−−filename=FILENAME
Set the filename
−−multiple
Allow selection of multiple filenames in file selection dialog
−−separator=SEPARATOR
Specify separator character when returning multiple filenames
Info options
−−text=STRING
Set the dialog text
List options
−−text=STRING
Set the dialog text
−−column=STRING
Set the column header
−−checklist
Use check boxes for first column
−−radiolist
Use radio buttons for first column
−−separator=STRING
Set output separator character
−−editable
Allow changes to text
−−print-column=STRING
Specify what column to print to standard output. The default is to return the first column. ’ALL’ may be used to print all columns.
Notification
options
−−text=STRING
Set the notification text
Progress
options
−−text=STRING
Set the dialog text
−−percentage=INT
Set initial percentage
−−auto−close
Close dialog when 100% has been reached
−−pulsate
Pulsate progress bar
Question options
−−text=STRING
Set the dialog text
Text options
−−filename=FILENAME
Open file
−−editable
Allow changes to text
Warning options
−−text=STRING
Set the dialog text
Miscellaneous
options
−?, −−help
Show summary of options.
−−about
Display an about dialog.
−−version
Show version of program.
Also the standard GTK+ options are accepted.
Display a file selector with the title Select a file to remove. The file selected is returned on standard output.
zenity −−title="Select a file to remove" −−file-selection
Display a text entry dialog with the title Select Host and the text Select the host you would like to flood-ping. The entered text is returned on standard output.
zenity −−title "Select Host" −−entry −−text "Select the host you would like to flood-ping"
Display a dialog, asking Microsoft Windows has been found! Would you like to remove it?. The return code will be 0 (true in shell) if OK is selected, and 1 (false) if Cancel is selected.
zenity −−question −−title "Alert" −−text "Microsoft Windows has been found! Would you like to remove it?"
Show the search results in a list dialog with the title Search Results and the text Finding all header files....
find . −name ’*.h’ | zenity −−list −−title "Search Results" −−text "Finding all header files.." −−column "Files"
Show an icon in the notification area
zenity −−notification −−window-icon=update.png −−text "System update necessary!"
Display a weekly shopping list in a check list dialog with Apples and Oranges pre selected
zenity −−list −−checklist −−column "Buy" −−column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
Display a progress dialog while searching for all the postscript files in your home directory
find $HOME −name ’*.ps’ | zenity −−progress −−pulsate
Zenity was written by Glynn Foster <glynn.foster@sun.com>.
This manual page was written by Ross Burton <ross@burtonini.com>.
gdialog(1), dialog(1)
![]() |
zenity(1) | ![]() |