|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands zenity(1)
NAME
zenity, gdialog - display simple GNOME dialogs
SYNOPSIS
zenity --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] [--separator=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+_options
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 compatibil-
ity with older scripts.
OPTIONS
Zenity 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
SunOS 5.10 Last change: 20 Jul 2004 1
User Commands zenity(1)
version number and the author.
--version Display the version number of Zen-
ity.
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 informa-
tion 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.
SunOS 5.10 Last change: 20 Jul 2004 2
User Commands zenity(1)
--progress Display a progress indication dia-
log.
--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 exam-
ple %A %d/%m/%y.
--day=number Set the calendar day.
SunOS 5.10 Last change: 20 Jul 2004 3
User Commands zenity(1)
--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 multiple selections.
SunOS 5.10 Last change: 20 Jul 2004 4
User Commands zenity(1)
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 con-
tains check boxes.
--column=text Set the text of a column.
--editable Specify that the dialog contents are
editable.
--radiolist Specify that the first column con-
tains 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.
Progress-Indication Dialog Options
The following progress-indication dialog options are sup-
ported:
--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 pul-
sates until an EOF character is read
SunOS 5.10 Last change: 20 Jul 2004 5
User Commands zenity(1)
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 sup-
ported:
--editable Specify that the dialog contents are
editable.
--filename=path Set the file to display in the dia-
log.
Warning Dialog Options
The following warning dialog options are supported:
--text=text Set the dialog text.
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
SunOS 5.10 Last change: 20 Jul 2004 6
User Commands zenity(1)
Example 3: Launching Zenity Using the Text Informational
Dialog
example% zenity --text-info --title="LGPL License" \
--filename="/home/user1/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.
SunOS 5.10 Last change: 20 Jul 2004 7
User Commands zenity(1)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWzenity |
|_____________________________|_____________________________|
| Interface stability | External |
|_____________________________|_____________________________|
SEE ALSO
Zenity Manual
Latest version of the GNOME Desktop User Guide for your
platform.
NOTES
Written by Glynn Foster, Sun Microsystems Inc., 2003, 2004.
SunOS 5.10 Last change: 20 Jul 2004 8
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:42 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
svn man page (17415 hits) (FreeBSD 6.2)
netcat man page (7536 hits) (Suse Linux 10.1)
sqlite3 man page (7230 hits) (openSUSE 10.2)
ssh-socks5-proxy-connect man page (7009 hits) (Solaris 10 11_06)
prstat man page (6696 hits) (Solaris 10 11_06)
signal man page (6531 hits) (Suse Linux 10.1)
adv_cap_autoneg man page (6216 hits) (Solaris 10 11_06)
CPAN man page (5979 hits) (Suse Linux 10.1)
startproc man page (5178 hits) (Suse Linux 10.1)
ssh man page (5141 hits) (Suse Linux 10.1)
|