Method ilcd.Touch.setTouchFieldTextMessage

static void setTouchFieldTextMessage(int messageIndex)

Throws:

static void setTouchFieldTextMessage(String messageName)

Throws:

_INSERT_METHOD_SIGNATURE_HERE_

Parameter	Range	Description
messageIndex	0 ... max. text message index	index of the text message

Parameter	Range	Description
messageName	ASCII chars (0x01 .. 0xFF)	name of the message

Assigns the text message defined by messageIndex or messageName to any subsequently defined touch field (see Touch.createDefineTouchField(int, int)).

Calling this method does not change anything for touch fields already defined.
Setting messageIndex to 0xFFFF causes no text to be assigned to the subsequently defined touch field.
After startup and after calling the General.resetAll() method messageIndex is set to -1.
Text messages assigned to touch fields are used by the Touch.drawTouchFieldTextMessage(int) method.
The text message can even contain any valid ANSI sequence so allowing various attributes/fonts to be changed easily.
At this time, the attributes message offset, prefix and suffix are ignored and the existence of the message index or name is not verified (see Extra.setMessageOffset(int), Extra.setMessageNamePrefix(String) and Extra.setMessageNameSuffix(String)). Offset resp. pre-/suffix is taken into account when the message is actually drawn (see Touch.drawTouchFieldTextMessage(int)).

Example

Touch.setTouchFieldTextMessage(3);

Assigns the text message with index 3 to any subsequently defined touch field.