Set Touch Field Make Macro

by index:

\i T M word::macro_index

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

by name:

\i T M 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 pressed.

Note

If a make macro is assigned to a touch field, the cursor position is automatically updated to the origin of the pressed 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 pressed, 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 pressed 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 make event or by the Execute Touch Make Macro command).

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

Response:

[ACK]

Example

\iTM\D2

Assigns the macro with index 2 as make macro to the subsequently defined touch fields.