24 user input functions, 1 msgbox() – Teledyne LeCroy SierraFC Verification Script Engine Reference Manual User Manual

Page 54

Advertising
background image

Verification Script Engine Reference Manual

49

24 User input functions

24.1 MsgBox()

Displays a message in a dialog box, waits for the user to click a button, and returns an Integer

indicating which button the user clicked.

Format :

MsgBox( prompt, type, title )


Parameters:

prompt - Required. String expression displayed as the message in the dialog box.

type - Optional. Numeric expression that is the sum of values specifying the number

and type of buttons to display, the icon style to use, the identity of the default
button, and the modality of the message box. If omitted, the default value for
buttons is _MB_OK. ( See the list of possible values in the table below )

title - Optional. String expression displayed in the title bar of the dialog box. If you omit

title, the script name is placed in the title bar.

The type argument values are:
Constant

Description

_MB_OKONLY

Display OK button only ( by Default ).

_MB_OKCANCEL

Display OK and Cancel buttons.

_MB_RETRYCANCEL

Display Retry and Cancel buttons.

_MB_YESNO

Display Yes and No buttons.

_MB_YESNOCANCEL

Display Yes, No, and Cancel buttons.

_MB_ABORTRETRYIGNORE

Display Abort, Retry, and Ignore buttons.

_MB_EXCLAMATION

Display Warning Message icon.

_MB_INFORMATION

Display Information Message icon.

_MB_QUESTION

Display Warning Query icon.

_MB_STOP

Display Critical Message icon.

_MB_DEFBUTTON1

First button is default.

_MB_DEFBUTTON2

Second button is default.

_MB_DEFBUTTON3

Third button is default.

_MB_DEFBUTTON4

Fourth button is default.








Return Values:

This function returns an integer value indicating which button the user clicked.

Constant

Description

_MB_OK

OK button was clicked.

Advertising