OSK on devices with a QWERTY keyboard

From Java Runtime 1.4 for S60 onwards, some Touch UI devices may feature a physical keyboard. Therefore their needs for an on-screen keypad could be perceived minimal. However, the QWERTY keyboard (see table Return values for com.nokia.keyboard.type) used by some of those devices mode does not include softkeys at all. For backwards compatibility, softkeys need to still be presented on the screen.

On such a device, as long as the physical keyboard is closed, the on-screen keypad is presented as normal. When the keyboard is opened, the MIDlet uses an on-screen keypad mode where only the softkey part of the on-screen keypad is displayed on screen. The QWERTY keyboard is then used as the main input method and the OSK is only used for the softkey functions.

Note: If a MIDlet has set the value no for the JAD attribute Nokia-MIDlet-On-Screen-Keypad, no on-screen keypad is displayed in any mode.

You can set the softkeys to be placed in either the bottom or the right side of the screen by using the JAD attribute Nokia-MIDlet-On-Screen-Softkeys-Position. The results are shown in the following table for landscape orientation:

Table: Softkey locations on an on-screen keypad

Softkeys on right side

Softkeys at the bottom