![]() |
![]() |
dialog.messageShows a message box |
|
Syntax | |
|
|
Description | |
Shows a message dialog box with the specified <caption> , <message_text> , <icon> and
buttons. <caption> is a text string that will appear in the caption of the dialog box. <message_text> is a text string that will appear in the dialog box and can contain HTML formatting. <icon> is an image identifier that defines an icon to be placed in the dialog box. <icon> can be a relative or absolute path to an image file , a signed number (in that case it defines an internal KVIrc image) or one of the special strings "critical", "information" and "warning". <button0> is the text of the first button (on the left). <button1> is the text of the second button (if empty or not given at all, only one button will appear in the dialog). <button2> is the text of the third button (if empty or not given, only two buttons will appear in the dialog). <magic1>,<magic2>... are the magic parameters: evaluated at dialog.message call time and passed to the <callback_command> as positional parameters. Once the dialog has been shown , the user will click one of the buttons. At this point the dialog is hidden and the <callback_command> is executed passing the number of the button clicked as $0 and the magic parameters as positional parameters $1 , $2 , $3.... Please note that if the user closes the window with the window manager close button , the action is interpreted as a button2 click (that is usually sth as "Cancel"). |
|
Examples | |
|