Set Touch Field Break Macro

by index:

\i T B word::macro_index

Parameter	Type	Range	Description
macro_index	word	0 ... max. macro index (-1 = none)	index of the macro

by name:

\i T B by_name::macro_name

Parameter	Type	Range	Description
macro_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated macro name

Assigns the macro to be called when any subsequently defined (see Create/Define Touch Field) touch field is released.

Note

If a break macro is assigned to a touch field, the cursor position is automatically updated to the origin of the released touch field before executing the macro.
When automatic execution of touch macros is disabled (refer to Enable/Disable Automatic Touch Macro Executing) and the touch field is released, the cursor position will be updated but the macro will not be executed.
Automatically executed Touch Macros do not send an extra [ACK] after execution is finished. They do however send a [NACK] if one of the macro commands fail.
Setting macro_index to 0xFFFF (decimal word –1) causes no macro to be executed when the subsequently defined touch field is released and the cursor position will not be updated.
After startup and after sending the Reset All command macro_index is set to -1.
At this time, the attributes macro offset, prefix and suffix are ignored and the existence of the macro index or name is not verified (see Set Macro Offset, Set Macro Name Prefix and Set Macro Name Suffix). Offset resp. pre-/suffix is taken into account when the macro is actually executed (in case of the according break event or by the Execute Touch Break Macro command).

Sending this command does not change anything for touch fields already defined.

Response:

[ACK]

Example

\iTB\D1

Assigns the macro with index 1 as break macro to the subsequently defined touch fields.