Choice entry (<CE>) elements define items that a user can choose in a choice card. See the next section for a description of choice cards.
<CE
| |
| |
The label for the ACCEPT key when the choice entry is selected. When the choice entry is selected this label overrides any labels specified at the card or the deck level. | |
The task to execute. If you specify a task, it takes precedence over any actions specified at the card or deck level.
Possible
The options listed below (e.g. | |
The URL to request in
If the current activity is nested and the task is a | |
Instructs the phone to prefetch the URL specified by the If the user invokes the action (requesting the URL) the phone can retrieve the URL from the cache instead of requesting it from the UP.Link server. This gives the user a perception of enhanced performance. There is no guarantee that the phone will be able to prefetch the specified URL. For example, if the phone is on a circuit-switched network and the circuit is down, the phone will not open a circuit. If the phone fails to execute the prefetch, it does not retry it.
If you specify the
If several tasks on a card specify the | |
If the DEST option specifies a URL, the method used to request the URL:
If you do not specify this option, the default,
It is strongly recommended that you use the | |
The data to post if the | |
Specifies the character set which the HDML application expects data returned from the phone to use. It can specify character set names, such as the following:
For a complete list of character set names, see Supporting multiple character sets
If you do not specify the | |
A list of variables to set for the current activity (if the task is
Variable values must be escaped according to URL escaping conventions. The phone unescapes the | |
A semicolon-delimited list of variables to which the phone stores the return values from a The phone stores return values according to ordinal position. For example, if you specify the following option:
the phone stores the first return value to
If you want to skip a return value, you must include a semicolon as a placeholder. For example, to ignore the first return value and store the second return value to | |
A semicolon-delimited list of values that an activity invoked with The values must be escaped according to URL escaping conventions. | |
The URL to request after a nested activity returns.
If the | |
The URL to request after a nested activity invoked by a
If the | |
A boolean value specifying whether the nested activity specified in a
To indicate the nested activity is friendly, specify | |
A boolean value specifying whether the UP.Browser should provide the URL of the current deck when requesting the URL specified by the The UP.Browser attempts to use the shortest possible relative URL in the "Referer" header if possible. | |
A boolean value specifying whether a
The phone ignores the | |
>
| |
Formatted text describing the choice entry. You can insert an image as a choice item by using an
By default, the UP.Phone always displays the text in horizontal scrolling (
If you did not specify |
The following HDML deck demonstrates choice entries that specify ACCEPT key labels (as shown in Figure 2-4).
FIGURE 2-4.
Choice entries with ACCEPT key labels
You can include images within the formatted text associated with a choice entry by specifying an <IMG> statement as part of the text. The following example illustrates how to insert images using both the SRC and ICON options (see Figure 2-5).
FIGURE 2-5. Images in choice entries