@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: