Draw Touch Field Text Message

\i T D byte::field_idx

Parameter	Type	Range	Description
field_idx	byte	0 ... 63	index of the touch field (-1 = current index)

Draws the text message assigned to the touch field with index field_idx in its top left corner.

The message offset, prefix and suffix are taken into account (see Set Message Offset, Set Message Name Prefix and Set Message Name Suffix).
If field_idx is set to 0xFF (decimal byte -1) the 'current touch field index' is used (refer to Touch Screen Related Commands).
If no text message is assigned to the field and the key assigned to the field is other than 0x0, the key is printed instead. This behavior is useful for single character touch fields like "keyboard" fields, as no text message has to be assigned for every touch field.
If field_idx is out of bounds, the corresponding index has no active field attached or no text can be displayed, a [NACK] is sent by the iLCD Controller.
Note that when a make or break macro is executed, the cursor position is automatically set to the upper/left corner of the corresponding touch field. So when using this command inside a touch macro, text output can be placed or aligned (see Set Text Alignment) relative to the touch field position.

Response:

[ACK]

Example

\iDT\5

Draws the text message assigned to the touch field with index 5 in its top left corner, given the settings for the message offset aren't changed.