matedialog man page on Mageia

Man page or keyword search:  
man Server   17783 pages
apropos Keyword Search (all sections)
Output format
Mageia logo
[printable version]

MATEDIALOG(1)							 MATEDIALOG(1)

NAME
       matedialog - display GTK+ dialogs

SYNOPSIS
       matedialog [options]

DESCRIPTION
       matedialog  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, matedialog --question will return either 0 or 1, depending
       on  whether the user pressed OK or Cancel. matedialog --entry will out‐
       put on standard output what the user typed into the text entry field.

       Comprehensive documentation is available	 in  the  MATE	Help  Browser,
       under MATE/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

       --scale
	      Display scale dialog

       --color-selection
	      Display color selection 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', 'ques‐
	      tion' 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

       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

       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 col‐
	      umns.

       --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 exam‐
	      ple,  '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

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

       Warning options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       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

       Miscellaneous options

       -?, --help
	      Show summary of options.

       --about
	      Display an about dialog.

       --version
	      Show version of program.

       Also the standard GTK+ options are accepted.

ENVIRONMENT
       Normally, matedialog detects the terminal  window  from	which  it  was
       launched and keeps itself above that window.  This behavior can be dis‐
       abled 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.

	      matedialog  --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.

	      matedialog   --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.

	      matedialog  --question --title "Alert"  --text  "Microsoft  Win‐
	      dows 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' | matedialog --list --title "Search  Results"
	      --text "Finding all header files.." --column "Files"

       Show an icon in the notification area

	      matedialog  --notification --window-icon=update.png --text "Sys‐
	      tem update necessary!"

       Display a weekly shopping list in a check list dialog with  Apples  and
       Oranges pre selected

	      matedialog  --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' | matedialog --progress --pulsate

AUTHOR
       MateDialog 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		 MATEDIALOG(1)
[top]

List of man pages available for Mageia

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net