getSoftkeyStyle1 Method 
getSoftkeyStyle1 Method
Use
The getSoftkeyStyle1 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
isBackHardWired Method and getSoftkeyStyle2 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 use this information to find an appropriate display type 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
The following WML code is an example for the use of soft keys in a WML card.
<?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>