Method ilcd.Touch.createDefineTouchField

Package ilcd
Class Touch

Public Method createDefineTouchField

static void createDefineTouchField(int fieldIdx, int key)

Throws:

ILCDException

_INSERT_METHOD_SIGNATURE_HERE_

Description:

Parameter	Range	Description
fieldIdx	0 ... 63 (-1 = next free touch field index)	index of the touch field
key	0 ... 255	value reported in case of touch event

Creates or redefines the touch field with index fieldIdx with the current values and properties previously set (e.g. Touch.setTouchFieldWidth(int), etc.). The value key can be set in the range 0 till 255.

Note

The upper left position of the touch field is taken from the current cursor position.
fieldIdx may have the hex value 0xFF (decimal byte -1), in this case the controller will choose the next free (unassigned) touch field index.
Using this method also sets the 'current touch field index' (see Touch.setCurrentTouchFieldIndex(int)), which can be used by Touch.drawTouchFieldTextMessage(int).
If a value greater than 255, or smaller than 0 is assigned to the key the behavior is undefined.

Example

Touch.createDefineTouchField(-1, 0);

This will create a touch field with the next free index (fieldIdx). If the new created touch field is pressed the index (fieldIdx) of the touch field, the event type, the event coorinates, and the point ID (optional) will be set.