qwarning - information dialog displaying a warning

Name

qwarning — information dialog displaying a warning

Syntax

qwarning caption text [button-0-text] [button-1-text] [button-2-text]

Description

The qwarning command displays a read-only warning dialog with one or more buttons, along with a caption. The default is a single 'OK' button. The dialog is modal, therefore execution is halted until the user closes the dialog.

The dialog may optionally have up to three buttons to replace the default OK button. The buttons are implicitly numbered 0, 1, 2. The command will return the number corresponding to the button pressed by the user.

Arguments

caption

Dialog title.

text

The main text of the dialog

button-x-text

Text to appear on button number x. There may be 1, 2, or 3 buttons provided in place of the default OK button.

Examples

Ex.1: Warning dialog

# A titled dialog with a message and OK button
qwarning Warning "This is a warning"

The above example shows the simplest use of qwarning. The OK button is created automatically.

Ex.2: Information dialog with extra buttons

# Warning with title and buttons. 
# Returns 0 (OK), 1 (Cancel), 2 (Details)
set button [qwarning "Open File" "Failed to open file" OK Cancel Details]
if { $button == 0 } {
	# OK button was pressed
} elseif { $button == 1 } {
	# Cancel buttons was pressed
} elseif { $button == 2 } {
	# Details buttons was pressed
}

Example Information dialog with extra buttons shows a warning dialog with a title and extra buttons. The number 0, 1, or 2 is returned to the program, depending on which button the user clicks.