Use
The GET_SOFTKEY_STYLE2 method specifies how the type attribute "options" of the <do> tag is displayed on the mobile device screen.
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-specific and on some devices the tag can be displayed as a soft key (a type 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.
Therefore, the <do> tag defines the type of implementation on the mobile device.
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
GET_SOFTKEY_STYLE1 Method or GET_BACK_HARD_WIRED 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
<?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="Seite1">
<do type="accept" label="Weiter">
<go href="seite2.wml"/>
</do>
<do type="options" label="Exit">
<exit/>
</do>
</p>…
</card>
</wml>