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 forBUTIL MSGBOX MSG.
EM [ rc=-1 [ level=2 ]] ; text [; title ]
- Display the string
ERROR (rc): textin a message box with caption title (default:EM) and the only buttonOK. When the dialog is closed use the commandEXIT level INT rcto 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; 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