Teledyne LeCroy UWBTracer Verification Script Engine Manual - Manual (Page 83)

LeCroy Corporation Verification Script Engine Manual, version 2.2
Return Values:
This function returns an integer value indicating which button was clicked.
Constant Description
_MB_OK OK button was clicked.
_MB_CANCEL Cancel button was clicked.
_MB_YES Yes button was clicked.
_MB_NO No button was clicked.
_MB_RETRY Retry button was clicked.
_MB_IGNORE Ignore button was clicked.
_MB_ABORT Abort button was clicked.
Remark:
This function works only for VS Engines controlled via a GUI. For VSEs controlled by COM/Automation™ clients,
it does nothing.
This function "locks" the UWBTracer™ application, which means that there is no access to other application
features until the dialog box is closed. To prevent too many MsgBox calls (in case a script is not written
correctly), VSE keeps track of all function calls demanding user interaction and doesn't show dialog boxes if
some customizable limit is exceeded (returns _MB_OK in this case).
Example:
…
if(Something)
{
…
str = "Something happened!!!\nShould we continue?"
result = MsgBox(str ,
_MB_YESNOCANCEL | _MB_EXCLAMATION,
"Some Title");
if(result != _MB_YES)
ScriptDone();
# Go on…
}
Page 83 of 95