diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-D498AD58-DF42-4FBA-8767-91FC624873C0.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-D498AD58-DF42-4FBA-8767-91FC624873C0.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,37 @@ + + +append()

append()

+

Description:

+

Call the append method to add a child menu item +to the parent menu item in the options menu list. This results in the creation +of a submenu list in the menu tree. Use this method to create a cascading +submenu when needed.

+

Menu items are shown on the options menu list in the order in which +they are appended.

+

Syntax:

+
[void] MenuItem.append(MenuItem childMenuItem)
+

Arguments:

+
    +
  • childMenuItem:

    + +

    This is an instance of the MenuItem object +which is being added to the parent menu item. See also the menu.append method description for instructions on how to append a menu item +to the top level of the options menu list.

    + +
  • +
+

Return value:

+

This method does not return a value.

+

Remarks:

+

For devices with a small screen, it is not practical to create multi-level +cascading submenus. Thus, a maximum of two-levels is recommended for submenus.

+

Appending a new menu item fails if it tries to create a duplicate menu +item (it either has the same id or the same label as +an existing menu item).

+

For more general information on constructing an options menu, see Using softkeys.

+

Example code:

+

See the example code in the description of the MenuItem.onSelect property.

+
\ No newline at end of file