Method WMLCard():task()

Create a task.

:task( [<cLabel>], ;
       <cURL>    , ;
       [<cType>] , ;
       [<cOptions>] ) --> self

The optional parameter <cLabel> becomes the value of the label attribute in the WML <do> tag.

<cURL>

The parameter <cURL> becomes the value of the href attribute in the WML <go> tag.

<cType>

The optional parameter <cType> becomes the value of the type attribute in the WML <do> tag.

The optional parameter <cOptions> is a character string that is inserted into the WML <do> tag.

This method returns the object executing the method (self).

The method specifies a task in a card which usually defines how a user can navigate beween cards in a deck or between WML documents. The parameter <cURL> indicates the target of the task, i.e. this is what the mobile device is to load when the user activates the link indicated with <cLabel>.

The parameter <cType> defaults to "accept" (=positive acknowledgement). Other valid types for a task are "prev" (=backward navigation), "help" (=request for help) and "refresh" (=reload current document).

WML output when <cURL> is a #cardID or a http: link:

<do type="cType" [label="cLabel"] [cOptions]> 
 <go href="cURL"/> 
</do>

WML output when <cURL> is a predefined task such as <prev/>:

<do type="cType" [label="cLabel"] [cOptions]> 
<prev/> 
</do>

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Method WMLCard():task() Professional