getSoftkeyStyle2 Method 
getSoftkeyStyle2 Method
Use
The getSoftkeyStyle2 method specifies the display of the type attribute options of the <do> tags on the screen of the mobile device.
Features
Using the <do> tag offers the user more navigation and control options on mobile devices, and for some devices enables you, for example, to customize the menu bar at the bottom of the screen. You can use predefined actions like go, prev, help, or noop as controls. These are executed by pressing the corresponding keys on the mobile device.
The display of this tag on the screen is browser-dependent and in some devices the tag can be converted into a visible soft key, a kind of navigation button, in the menu bar at the bottom of the screen. For example, you can switch to the next card by using the <go> action and then directly select a Web address by using the interface element that is defined by the <do> tag. In so doing, the <do> tag assigns a defined function to a key on the mobile device. If you press this key, the <do> event occurs, which in turn triggers the <go> action.
You specify the type of the event using the type attribute of the <do> tag. This means you pass information about the content of the event and the associated action to the mobile device. The mobile devices use this information to find an appropriate display type for the execution of this action.
If you assign the "options" value to the type attribute of the <do> tag, interface elements are displayed that you can use to call a list of context-sensitive options or a selection list.
The type value "options" should be used in a <do> tag if you have already defined a soft key of the type "accept" in a card.
On some devices, the <do> tag is displayed as a soft key at the bottom of the screen and the corresponding action is executed with a device key. This type of implementation of the <do> tag on mobile devices is very common, however, on some devices, the <do> tag is displayed as a selection option in the menu, as a button on a touch screen of a mobile hand-held device, or it is not displayed at all.
(see also
getSoftkeyStyle1 Method and isBackHardWired Method)Values
|
Values |
Short Description |
Example |
|
notShown |
The <do> tag does not appear on the screen. |
|
|
key |
The <do> tag is displayed as a soft key and the function is assigned to a device key. |
|
|
menu |
The <do> tag appears as a selection option in the menu. |
|
|
screen |
The <do> tag appears as a button on the screen. |
For example, on the touch screen of a hand-held device like a PDA or Pocket PC. Tapping the screen (with a special pen) triggers the action. |
Example
The following WML code is an example for the use of soft keys.
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card title="Page1">
<do type="accept" label="Continue">
<go href="page2.wml"/>
</do>
<do type="options" label="Exit">
<exit/>
</do>
</p>…
</card>
</wml>