matedialog (1) - Linux Manuals

matedialog: display GTK+ dialogs

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 output 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', '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

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

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

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 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' | 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 "System 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 [at] sun.com>.

This manual page was written by Ross Burton <ross [at] burtonini.com>.