GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ZENITY (1)

NAME

zenity - display GTK+ dialogs

CONTENTS

Synopsis
Description
Options
Environment
Examples
Author
See Also

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.

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 Finding 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 directory

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)
Search for    or go to Top of page |  Section 1 |  Main Index


--> ZENITY (1) December 2011

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.