UM or EM - Display a User-Message (UM) or Error-Message (EM)
From STX Wiki
Jump to navigationJump to search
UM text [; title ]
- Display the argument text in a message box with caption title (default:
UM
) and the only buttonOK
. This function is a shortcut forMSGBOX 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 buttonOK
. When the dialog is closed use the commandEXIT 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:
[macro umemtest] 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 // this point should nevel be reached! conlog '$#mac: you should never see this message - something goes wrong!' exit 1 int 0