From Series 40 6th Edition onwards, some Series 40 devices include a
force-sensitive joystick, which can detect full 360 degree scrolling movement
and force input generated by the device user. For these devices, Nokia UI
API is extended with a listener interface to learn when the state of the joystick
changes. The joystick events are listened with the com.nokia.mid.ui.JoystickEventListener
interface.
The following features are supported:
A device may support a force sensitive joystick which detects 360 directions and force instead of standard 5 way key navigation. (Up, Down, Left, Right and Centre).
The force sensitive joystick sends events every time its position or force changes. This events are represented by x (horizontal) and y (vertical) vector components. In its original position (centre), the value for (x, y) are (0,0).
The maximum and minimum values of x and y are -127
and 127
.
System.getProperty("com.nokia.mid.ui.joystick_event")
returns true
if
this feature is available in the device.
For an example of using joystick events, see article Developing Java ME applications with force-sensitive joystick and Force Sensitive Joystick API in Forum Nokia wiki.