Method XbpMenuBar():setItem() Foundation

Replaces the specified menu item in the menu.

:setItem( <nItemIndex>, <aItem> ) --> lSuccess
<nItemIndex> is a numeric value specifying the ordinal position in the menu object of the menu item to replace.
<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.

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


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).


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.