@MSGBOX |
|
| Top Previous Next | |
Syntax:
@MSGBOX(<message>, <title>, <icon/button styles>)
Description:
This function displays a standard Windows message dialog box with the message, title, buttons and icons specified, and returns a value which indicates which button was pressed.
[VDS6] The <icon/button styles> can be specified by adding one style from each of the following types, separated by commas.
[VDS5] The <icon/button styles> must be specified using a single hexadecimal value formed by adding one value selected from each of the following types.
Type |
Description |
Style |
Value |
Buttons |
OK |
OK |
(Default) |
|
OK, Cancel |
OKCANCEL |
$1 |
|
Yes, No |
YESNO |
$4 |
|
Yes, No, Cancel |
YESNOCANCEL |
$3 |
|
Abort, Retry, Ignore |
ABORTRETRYIGNORE |
$2 |
|
Cancel, Try Again, Continue |
CANCELTRYCONTINUE |
$6 (Windows 2000, XP only) |
|
Retry, Cancel |
RETRYCANCEL |
$5 |
Icons |
Error |
ERROR |
$10 |
|
Question mark |
QUESTION |
$20 |
|
Information symbol |
INFORMATION |
$40 |
|
Exclamation mark |
WARNING |
$30 |
Default button |
First button |
|
(Default) |
|
Second button |
DEF2 |
$100 |
|
Third button |
DEF3 |
$200 |
The return value indicates which button was pressed, according to the following list:
1 |
OK |
2 |
Cancel |
3 |
Abort |
4 |
Retry |
5 |
Ignore |
6 |
Yes |
7 |
No |
10 |
Try Again |
11 |
Continue |
The INFO and WARN commands, and the @ASK and @QUERY functions, offer a simpler way to create common message dialogs.
OK:
Unchanged.
Example:
IF @EQUAL(@MSGBOX(Cannot read from drive A:,Backup,RETRYCANCEL,WARNING),2)
STOP
END
See also: