Teledyne LeCroy SAS_SATA Protocol Suite Verification Script Engine Reference Manual - Manual (Page 75)

75
Return Values
This function returns an integer value indicating which button the user 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 the GUI. For VSEs controlled by
COM/Automation clients, it does nothing.
This function "locks" the SASSuite/SATASuite application, which means that there is no access
to other application features until the dialog box is closed. In order to prevent too many MsgBox
calls, in the case of a script not written correctly, VSE keeps track of all function calls
demanding user interaction and does not show dialog boxes if a customizable dialog limit was
exceeded (and 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…
}