Reference

kdialog(1)

Show KDE dialog boxes from shell scripts

NAME

kdialog - Show KDE dialog boxes from shell scripts

SYNOPSIS

kdialog [Qt-options] [KDE-options] [options] [arg]

DESCRIPTION

This manual page documents briefly the kdialog KDE Application. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

kdialog allows to display dialog boxes from shell scripts. The syntax is very much inspired from the dialog command (which shows text mode dialogs).

OPTIONS

--yesno text

Question message box with yes/no buttons

--yesnocancel text

Question message box with yes/no/cancel buttons

--warningyesno text

Warning message box with yes/no buttons

--warningcontinuecancel text

Warning message box with continue/cancel buttons

--warningyesnocancel text

Warning message box with yes/no/cancel buttons

--sorry text

'Sorry' message box

--error text

'Error' message box

--msgbox text

Message Box dialog

--inputbox text init

Input Box dialog

--password text

Password dialog

--textbox file [width] [height]

Text Box dialog

--menu text [tag item] [tag item] ...

Menu dialog

--checklist text [tag item status] ...

Check List dialog

--radiolist text [tag item status] ...

Radio List dialog

--title text

Dialog title

--separate-output

Return list items on separate lines (for checklist option)

Arguments:

arg

Arguments - depending on main option

Generic options:

--help

Show help about options

--help-qt

Show Qt specific options

--help-kde

Show KDE specific options

--help-all

Show all options

--author

Show author information

-v, --version

Show version information

--license

Show license information

--

End of options

Qt options:

--display displayname

Use the X-server display displayname.

--session sessionId

Restore the application for the given sessionId.

--cmap

Causes the application to install a private color map on an 8-bit display.

--ncols count

Limits the number of colors allocated in the color cube on an 8-bit display, if the application is using the QApplication::ManyColor color specification.

--nograb

tells Qt to never grab the mouse or the keyboard.

--dograb

running under a debugger can cause an implicit -nograb, use -dograb to override.

--sync

switches to synchronous mode for debugging.

--fn, --font fontname

defines the application font.

--bg, --background color

sets the default background color and an application palette (light and dark shades are calculated).

--fg, --foreground color

sets the default foreground color.

--btn,--button color

sets the default button color.

--name name

sets the application name.

--title title

sets the application title (caption).

--visual TrueColor

forces the application to use a TrueColor visual on an 8-bit display.

--inputstyle inputstyle

sets XIM (X Input Method) input style. Possible values are onthespot, overthespot, offthespotandroot.

--im XIM-server

set XIM server.

--noxim

disable XIM.

--reverse

mirrors the whole layout of widgets.

KDE options:

--caption caption

Use caption as name in the titlebar.

--icon icon

Use icon as the application icon.

--miniicon icon

Use icon as the icon in the titlebar.

--config filename

Use alternative configuration file.

--dcopserver server

Use the DCOP Server specified by server.

--nocrashhandler

Disable crash handler, to get core dumps.

--waitforwm

Waits for a WM_NET compatible windowmanager.

--style style

sets the application GUI style.

--geometry geometry

sets the client geometry of the main widget.

AUTHOR

KDialog was written by David Faure <[email protected]>, Nick Thompson, Nick Thompson, Matthias Hoelzer <[email protected]> and David Gumbel <[email protected]>.
Please use http://bugs.kde.org to report bugs, do not mail the authors directly.
This manual page was prepared by Karolina Lindqvist <[email protected]> for the Debian GNU/Linux system (but may be used by others).