zenity



ZENITY(1)                                                            ZENITY(1)




NAME

       zenity - display GTK+ dialogs


SYNOPSIS

       zenity [options]


DESCRIPTION

       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.


OPTIONS

       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.



EXAMPLES

       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  --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 ‘echo $HOME‘ ’*.ps’ | zenity --progress --pulsate


AUTHOR

       Zenity was written by Glynn Foster <glynn.foster@sun.com>.

       This manual page was written by Ross Burton <ross@burtonini.com>.



SEE ALSO

       gdialog(1), dialog(1)



                              February 1st, 2003                     ZENITY(1)

Man(1) output converted with man2html