TopBarMenu() > Menu item methods

oTopBarMenu:setItem()

Replaces a MenuItem object in a TopBarMenu object.

Syntax

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

Arguments

<nItemPos>

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

<oMenuItem>

This is the MenuItem() object that replaces an existing one in the TopBarMenu object.

Description

Method :setItem() accepts a MenuItem() object and replaces the existing MenuItem object at position <nItemPos>. The return value is the self object. If <nItemPos> is outside the valid range, no menu item is replaced.