1
.TH ZENITY 1 "February 1st, 2003"
3
zenity \- display GTK+ dialogs
8
\fBzenity\fP is a program that will display GTK+ dialogs, and return
9
(either in the return code, or on standard output) the users
10
input. This allows you to present information, and ask for information
11
from the user, from all manner of shell scripts.
13
For example, \fBzenity --question\fP will return either 0 or 1,
14
depending on whether the user pressed \fIOK\fP or \fICancel\fP. \fBzenity
15
--entry\fP will output on standard output what the user typed into the
18
Comprehensive documentation is available in the GNOME Help Browser,
19
under \fIGNOME/Utilities\fP.
21
This program follows the usual GNU command line syntax, with long
22
options starting with two dashes (`-').
29
Display calendar dialog
32
Display text entry dialog
38
Display file selection dialog
47
Display notification icon
50
Display progress indication dialog
53
Display question dialog
56
Display text information dialog
59
Display warning dialog
68
.B \-\-window-icon=ICONPATH
87
Set the calendar month
92
.B \-\-date-format=STRING
93
Set the format for the returned date
102
.B \-\-entry-text=STRING
115
File selection options
117
.B \-\-filename=FILENAME
121
Allow selection of multiple filenames in file selection dialog
123
.B \-\-separator=SEPARATOR
124
Specify separator character when returning multiple filenames
140
Set the column header
143
Use check boxes for first column
146
Use radio buttons for first column
148
.B \-\-separator=STRING
149
Set output separator character
152
Allow changes to text
154
.B \-\-print-column=STRING
155
Specify what column to print to standard output. The default is to return
156
the first column. 'ALL' may be used to print all columns.
163
Set the notification text
172
.B \-\-percentage=INT
173
Set initial percentage
176
Close dialog when 100% has been reached
190
.B \-\-filename=FILENAME
194
Allow changes to text
204
Miscellaneous options
208
Show summary of options.
211
Display an about dialog.
214
Show version of program.
217
Also the standard GTK+ options are accepted.
221
Display a file selector with the title \fISelect a file to
222
remove\fP. The file selected is returned on standard output.
224
zenity --title="Select a file to remove" --file-selection
226
Display a text entry dialog with the title \fISelect Host\fP and the
227
text \fISelect the host you would like to flood-ping\fP. The entered
228
text is returned on standard output.
230
zenity --title "Select Host" --entry --text "Select the host you would like to flood-ping"
232
Display a dialog, asking \fIMicrosoft Windows has been found! Would
233
you like to remove it?\fP. The return code will be 0 (true in shell)
234
if \fIOK\fP is selected, and 1 (false) if \fICancel\fP is selected.
236
zenity --question --title "Alert" --text "Microsoft Windows has been found! Would you like to remove it?"
238
Show the search results in a list dialog with the title \fISearch Results\fP
239
and the text \fIFinding all header files...\fP.
241
find . -name '*.h' | zenity --title "Search Results" --text "Finding all header files.." --column "Files"
243
Show an icon in the notification area
245
zenity --notification --window-icon=update.png --text "System update necessary!"
247
Display a weekly shopping list in a check list dialog with \fIApples\fP and \fIOranges\fP pre selected
249
zenity --list --checklist --column "Buy" --column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
251
Display a progress dialog while searching for all the postscript files in your home directory
253
find `echo $HOME` '*.ps' | zenity --progress --pulsate
255
\fBZenity\fP was written by Glynn Foster <glynn.foster@sun.com>.
257
This manual page was written by Ross Burton <ross@burtonini.com>.
260
\fBgdialog\fP(1), \fBdialog\fP(1)