Execute Protected Macro

by index:

\i O e byte::macro_index

by name:

\i O e by_name::macro_name

Executes (calls) the macro specified by macro_index or macro_name. Macros called with this command will not be interrupted by touch or keyboard events. The first touch event happening during execution of a protected macro will be buffered and reported after the macro returns or a Allow Keyboard/Touch Events to be Processed command is executed within the macro. New commands sent via any interface can still interrupt the macro.

Note

• If the macro does not exist or one of the called commands returns an error, [NACK] is returned.
• When the macro is fully executed, an [ACK] is sent. When called within another macro, execution returns to and continues processing the calling macro.
• When addressing by index, the macro offset (see Set Macro Offset) is taken into account.
• When addressing by name, the macro prefix (refer to Set Macro Name Prefix) and suffix (refer to Set Macro Name Suffix) are taken into account.
• Macros can call other macros, as long as the maximum nesting level is not exhausted. If a macro is executed within another macro ("nested"), the calling macro is resumed after the position where the macro was called once the called macro is finished.
• For building endless loops, use the Jump to Macro command to jump to the beginning of the current macro instead of using the Execute Macro command (this would overflow the macro stack and an error would be reported).

Example

\iOe\D1
\iOe\mMACRO\0

Executes the macro with index 1 and macro "MACRO" protected from touch or keyboard events.

Not supported by: DPC3020, DPC2060, DPC10xx

See also:

Macro Related Commands
Execute Macro
Jump to Macro
Set Macro Offset
Set Macro Name Prefix
Set Macro Name Suffix

Copyright © demmel products gmbh. All rights reserved.