Programmer Guide/Macro Library/UM: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| (8 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:UM or EM - Display a User-Message (UM) or Error-Message (EM)}} | {{DISPLAYTITLE:UM or EM - Display a User-Message (UM) or Error-Message (EM)}} | ||
UM <var>text</var> [; <var>title</var> ] | UM <var>text</var> [; <var>title</var> ] | ||
:Display the argument <var>text</var> in a message box with caption <var>title</var> (default: <code>UM</code>) and the only button <code>OK</code>. This function is a shortcut for <code>MSGBOX MSG | :Display the argument <var>text</var> in a message box with caption <var>title</var> (default: <code>UM</code>) and the only button <code>OK</code>. This function is a shortcut for <code>[[Programmer_Guide/Macro_Library/BUTIL#MsgBox|BUTIL MSGBOX MSG]]</code>. | ||
EM [ <var>rc</var>=-1 [ <var>level</var>=2 ]] ; <var>text</var> [; <var>title</var> ] | EM [ <var>rc</var>=-1 [ <var>level</var>=2 ]] ; <var>text</var> [; <var>title</var> ] | ||
:Display the string <code>ERROR (<var>rc</var>) <var>text</var></code> in a message box with caption <var>title</var> (default: <code>EM</code>) and the only button <code>OK</code>. When the dialog is closed use the command [[Programmer_Guide/Command_Reference/EXIT|<code>EXIT <var>level</var> INT <var>rc</var></code>]] to return. | :Display the string <code>ERROR (<var>rc</var>): <var>text</var></code> in a message box with caption <var>title</var> (default: <code>EM</code>) and the only button <code>OK</code>. When the dialog is closed use the command [[Programmer_Guide/Command_Reference/EXIT|<code>EXIT <var>level</var> INT <var>rc</var></code>]] to return from <var>level</var> macro levels. | ||
{|class="einrahmen" | |||
!argument !!description !!default | |||
|- | |||
|<var>text</var> | |||
|The message text to be displayed. | |||
| | |||
|- | |||
|<var>title</var> | |||
|The caption of the message box. | |||
|<code>UM</code> or <code>EM</code> | |||
|- | |||
|<var>rc</var> | |||
|The return code of the EM function. This must be an integer number. | |||
|<code>-1</code> | |||
|- | |||
|<var>level</var> | |||
| The number of macro levels to be closed (see command [[Programmer_Guide/Command_Reference/EXIT|<code>EXIT</code>]] for details) | |||
| <code>2</code> (return to caller) | |||
|- | |||
!RESULT !!description | |||
|- | |||
|''undefined'' || for the function <code>UM</code> | |||
|- | |||
|<var>rc</var> || for the function <code>EM</code> (value is returned to the macro defined b< <var>level</var>) | |||
|} | |||
Example: | |||
<pre> | <pre> | ||
um | [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 | |||
</pre> | </pre> | ||
Latest revision as of 09:38, 17 January 2017
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
