Method XbpMenuBar():setItem() Foundation

Replaces the specified menu item in the menu.

Syntax
:setItem( <nItemIndex>, <aItem> ) --> lSuccess
Parameters
<nItemIndex>
<nItemIndex> is a numeric value specifying the ordinal position in the menu object of the menu item to replace.
<aItem>
<aItem> is an array containing between two and four elements. These elements define the menu item. For more information see the discussion of the :addItem()) method.
Return

This method returns the value .T. (true) if the menu item could be replaced, otherwise it returns .F. (false).

Description

The :setItem() method replaces existing menu items in the menu object. This allows the menu appearance to be dynamically changed at runtime. This capability should rarely be needed, since the user interface does not need to be changed very often. The <aItem>parameter is the same as for the method :addItem() (see the :additem() method for more information).

Feedback

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.