...
Name
qinformation — information dialog
Syntax
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
qinformation caption text [button-0-text _] \[ _button-1-text _] \[ _button-2-text _] {panel} h2. Description The *qinformation* command displays a] |
Description
The qinformation command displays a read-only
...
message
...
dialog
...
with
...
one
...
or
...
more
...
buttons
...
together
...
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:
...
Information
...
dialog
...
| Anchor | ||||
|---|---|---|---|---|
|
| No Format | ||||
|---|---|---|---|---|
| ||||
# A titled dialog with a message and OK button
qinformation Information "Hello World"
{noformat}
!att:_img_cmd^qinformation.png!
The above example shows the simplest possible use of *qinformation*. The *OK* button is created automatically.
h3. |
The above example shows the simplest possible use of qinformation. The OK button is created automatically.
Ex.2:
...
Information
...
dialog
...
with
...
extra
...
buttons
...
| Anchor | ||||
|---|---|---|---|---|
|
| No Format | ||||
|---|---|---|---|---|
| ||||
# Message with title and buttons.
# Returns 0 (OK), 1 (Cancel), 2 (Details)
set button [qinformation "Open File" "The file was successfully opened" OK Cancel Details]
if { $button == 0 } {
# OK button was pressed
} elseif { $button == 1 } {
# Cancel buttons was pressed
} elseif { $button == 2 } {
# Details buttons was pressed
}
{noformat}
!att:_img_cmd^qinformation_buttons.png!
Example [#Information dialog with extra buttons] shows a message 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.
{pagebreak} |
Example Information dialog with extra buttons shows a message 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.