CentOS 7.0 - man page for zenity (centos section 1)

Linux & Unix Commands - Search Man Pages

Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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, 1 or 5, depending on whether the user
       pressed OK, Cancel or timeout has been reached. 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

       --progress
	      Display progress indication dialog

       --question
	      Display question dialog

       --text-info
	      Display text information dialog

       --warning
	      Display warning dialog

       --scale
	      Display scale dialog

       --color-selection
	      Display color selection dialog

       --password
	      Display password dialog

       --forms
	      Display forms dialog

       General options

       --title=TITLE
	      Set the dialog title

       --window-icon=ICONPATH
	      Set the window icon with the path to an image. Alternatively, one of the four stock
	      icons can be used: 'error', 'info', 'question' or 'warning'

       --width=WIDTH
	      Set the dialog width

       --height=HEIGHT
	      Set the dialog height

       --timeout=TIMEOUT
	      Set the dialog timeout in seconds

       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=PATTERN
	      Set  the format for the returned date. The default depends on the user locale or be
	      set with the strftime style. For example %A %d/%m/%y

       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

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       File selection options

       --filename=FILENAME
	      Set the file or directory to be selected by default

       --multiple
	      Allow selection of multiple filenames in file selection dialog

       --directory
	      Activate directory-only selection

       --save Activate save mode

       --separator=SEPARATOR
	      Specify separator character when returning multiple filenames

       --confirm-overwrite
	      Confirm file selection if filename already exists

       --file-filter=NAME | PATTERN1 PATTERN2
	      Sets a filename filter

       Info options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       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

       --multiple
	      Allow multiple rows to be selected

       --editable
	      Allow changes to text

       --print-column=NUMBER
	      Specify what column to print to standard output. The default is to return the first
	      column. 'ALL' may be used to print all columns.

       --hide-column=NUMBER
	      Hide a specific column

       --hide-header
	      Hides the column headers

       Notification options

       --text=STRING
	      Set the notification text

       --listen
	      Listen  for  commands  on stdin. Commands include 'message', 'tooltip', 'icon', and
	      'visible' separated by a colon. For  example,  'message:	Hello  world',	'visible:
	      false',  or  'icon:  /path/to/icon'.  The  icon command also accepts the four stock
	      icon: 'error', 'info', 'question', and 'warning'

       Progress options

       --text=STRING
	      Set the dialog text

       --percentage=INT
	      Set initial percentage

       --auto-close
	      Close dialog when 100% has been reached

       --auto-kill
	      Kill parent process if cancel button is pressed

       --pulsate
	      Pulsate progress bar

       --no-cancel
	      Hides the cancel button

       Question options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       --ok-label
	      Set the text of the OK button

       --cancel-label
	      Set the text of the cancel button

       Text options

       --filename=FILENAME
	      Open file

       --editable
	      Allow changes to text

       --checkbox=TEXT
	      Enable a checkbox for use like a 'I read and accept the terms.'

       --ok-label
	      Set the text of the OK button

       --cancel-label
	      Set the text of the cancel button

       Warning options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       Scale options

       --text=STRING
	      Set the dialog text

       --value=VALUE
	      Set initial value

       --min-value=VALUE
	      Set minimum value

       --max-value=VALUE
	      Set maximum value

       --step=VALUE
	      Set step size

       --print-partial
	      Print partial values

       --hide-value
	      Hide value

       Color selection options

       --color=VALUE
	      Set the initial color

       --show-palette
	      Show the palette

       Password dialog options

       --username
	      Display the username field

       Forms dialog options

       --add-entry=FIELDNAME
	      Add a new Entry in forms dialog

       --add-password=FIELDNAME
	      Add a new Password Entry in forms dialog

       --add-calendar=FIELDNAME
	      Add a new Calendar in forms dialog

       --text=STRING
	      Set the dialog text

       --separator=STRING
	      Set output separator character

       --forms-date-format=PATTERN
	      Set the format for the returned date. The default depends on the user locale or  be
	      set with the strftime style. For example %A %d/%m/%y

       Miscellaneous options

       -?, --help
	      Show summary of options.

       --about
	      Display an about dialog.

       --version
	      Show version of program.

       Also  the standard GTK+ options are accepted. For more information about the GTK+ options,
       execute following command.

	      zenity --help-gtk


ENVIRONMENT
       Normally, zenity detects the terminal window from which it was launched and  keeps  itself
       above  that  window.   This behavior can be disabled by unsetting the WINDOWID environment
       variable.

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  Find-
       ing all header files....

	      find  .  -name  '*.h'  | zenity --list --title "Search Results" --text "Finding all
	      header files.." --column "Files"

       Show a notification in the message tray

	      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 direc-
       tory

       find $HOME -name '*.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)

					  December 2011 				ZENITY(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 10:37 AM.

Unix & Linux Forums Content Copyright©1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?