beautypg.com

User input functions, Msgbox(), 19 user input functions – Teledyne LeCroy SATracer 3G Verification Script Engine manual User Manual

Page 58

background image

LeCroy Corporation

Verification Script Engine Reference Manual

Version 1.01

19 User Input Functions

19.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

the 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.

53