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 @@ + + +
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.