Teledyne LeCroy Verification Script Engine (VSE) Manual - Manual (Page 103)

Teledyne LeCroy Verification Script Engine Reference Manual
Page 103 of 115
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 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…
}