Use
The GET_SOFTKEY_STYLE1 method specifies how the type attribute accept of the <do> tag is displayed on the mobile device screen.
Features
The <do> tag is used to execute actions either by pressing a device key or by choosing a menu option.
Therefore, the <do> tag enables you to customize additional navigation and control options in addition to navigation with links. For this purpose, you can access the predefined functions (such as go, prev, or noop) using the type attribute in the <do> tag. For example, you can switch to the next card by using the <go> action. This is why the <do> tag plays an important role in navigation on mobile devices.
The display of the <do> tag on the screen is browser-dependent and the tag can be presented graphically as a soft key in the menu bar at the bottom of the screen.
(See also
GET_BACK_HARD_WIRED Method and GET_SOFTKEY_STYL2 Method)A soft key is similar to a control or an interface element. You can use it to execute processes if the <do> event occurs after pressing a device key.
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 process this information to use the appropriate display for the execution of this action.
If you assign the value "accept" to the type attribute of the <do> tag, interface elements are displayed that can be used for confirmation, for example, of a selection.
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.
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 id="Card1" title="Card1">
<do type="accept" label="Next">
<go href="#Card2"/>
</do>
<p>
Choose "Next" to continue
</p>
</card>
<card id="Card2" title="Card2">
<p>
Card2
</p>
</card>
</wml>