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 progress indication dialog
50
Display question dialog
53
Display text information dialog
56
Display warning dialog
65
.B \-\-window-icon=ICONPATH
84
Set the calendar month
89
.B \-\-date-format=STRING
90
Set the format for the returned date
99
.B \-\-entry-text=STRING
112
File selection options
114
.B \-\-filename=FILENAME
118
Allow selection of multiple filenames in file selection dialog
120
.B \-\-separator=SEPARATOR
121
Specify separator character when returning multiple filenames
137
Set the column header
140
Use check boxes for first column
143
Use radio buttons for first column
145
.B \-\-separator=STRING
146
Set output separator character
149
Allow changes to text
151
.B \-\-print-column=STRING
152
Specify what column to print to standard output. The default is to return
153
the first column. 'ALL' may be used to print all columns.
162
.B \-\-percentage=INT
163
Set initial percentage
166
Close dialog when 100% has been reached
180
.B \-\-filename=FILENAME
184
Allow changes to text
194
Miscellaneous options
198
Show summary of options.
201
Display an about dialog.
204
Show version of program.
207
Also the standard GTK+ options are accepted.
211
Display a file selector with the title \fISelect a file to
212
remove\fP. The file selected is returned on standard output.
214
zenity --title="Select a file to remove" --file-selection
216
Display a text entry dialog with the title \fISelect Host\fP and the
217
text \fISelect the host you would like to flood-ping\fP. The entered
218
text is returned on standard output.
220
zenity --title "Select Host" --entry --text "Select the host you would like to flood-ping"
222
Display a dialog, asking \fIMicrosoft Windows has been found! Would
223
you like to remove it?\fP. The return code will be 0 (true in shell)
224
if \fIOK\fP is selected, and 1 (false) if \fICancel\fP is selected.
226
zenity --question --title "Alert" --text "Microsoft Windows has been found! Would you like to remove it?"
228
Show the search results in a list dialog with the title \fISearch Results\fP
229
and the text \fIFinding all header files...\fP.
231
find . -name '*.h' | zenity --title "Search Results" --text "Finding all header files.." --column "Files"
233
Display a weekly shopping list in a check list dialog with \fIApples\fP and \fIOranges\fP pre selected
235
zenity --list --checklist --column "Buy" --column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
237
Display a progress dialog while searching for all the postscript files in your home directory
239
find `echo $HOME` '*.ps' | zenity --progress --pulsate
241
\fBZenity\fP was written by Glynn Foster <glynn.foster@sun.com>.
243
This manual page was written by Ross Burton <ross@burtonini.com>.
246
\fBgdialog\fP(1), \fBdialog\fP(1)