TopBarMenu() > Menu item methods

oTopBarMenu:insItem()

Inserts a MenuItem object into a TopBarMenu object.

Syntax

:insItem( <nItemPos>, <oMenuItem> ) --> self

Arguments

<nItemPos>

This is a numeric value specifying the ordinal position where to insert the menu item. The value for <nItemPos> must be in the range from 1 to :itemCount. Otherwise, it is ignored.

<oMenuItem>

This is the MenuItem() object to insert into the TopBarMenu object.

Description

Method :insItem() accepts a MenuItem() object and inserts it into the internal list of menu items at position <nItemPos>. The return value is the self object. The instance variable :itemCount reflects the new number of MenuItem() objects maintained by a TopBarMenu object. If <nItemPos> is outside the valid range, the number of menu items remains unchanged.