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

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.