Method ilcd.Touch.drawTouchFieldTextMessage

static void drawTouchFieldTextMessage(int fieldIdx)

Throws:

_INSERT_METHOD_SIGNATURE_HERE_

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

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

The message offset, prefix and suffix are taken into account (see Extra.setMessageOffset(int), Extra.setMessageNamePrefix(String) and Extra.setMessageNameSuffix(String)).
If fieldIdx is set to 0xFF (decimal byte -1) the 'current touch field index' is used (refer to Touch).
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.
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 method inside a touch macro, text output can be placed or aligned (see Control.setTextAlignment(int, int, int)) relative to the touch field position.

Example

Touch.drawTouchFieldTextMessage(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.