Programmer Guide/Macro Library/UM: Difference between revisions

From STX Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 29: Line 29:
|<var>rc</var> || for the function <code>EM</code> (value is returned to the macro defined b< <var>level</var>)
|<var>rc</var> || for the function <code>EM</code> (value is returned to the macro defined b< <var>level</var>)
|}
|}
Example:
<pre>
...
um press OK key to continue; UM - waiting for user input
...
em 107 2; press OK to exit this macro with return code 107; EM - waiting for user input
exit 1 int 0 // this point should never be reached!
</pre>

Revision as of 13:30, 29 January 2016

UM text [; title ]
Display the argument text in a message box with caption title (default: UM) and the only button OK. This function is a shortcut for MSGBOX MSG; text [; title=UM].
EM [ rc=-1 [ level=2 ]] ; text [; title ] 
Display the string ERROR (rc): text in a message box with caption title (default: EM) and the only button OK. When the dialog is closed use the command EXIT level INT rc to return from level macro levels.
argument description default
text The message text to be displayed.
title The caption of the message box. UM or EM
rc The return code of the EM function. This must be an integer number. -1
level The number of macro levels to be closed (see command EXIT for details) 2 (return to caller)
RESULT description
undefined for the function UM
rc for the function EM (value is returned to the macro defined b< level)

Example:

...
um press OK key to continue; UM - waiting for user input
...
em 107 2; press OK to exit this macro with return code 107; EM - waiting for user input
exit 1 int 0 // this point should never be reached!

Navigation menu

Personal tools