Method XbpMenuBar():insItem() Foundation

Inserts a menu item into the menu.

:insItem( <nItemIndex>, <aItem> ) --> lSuccess
<nItemIndex> is a numeric value specifying the ordinal position within menu where the menu item is inserted.
<aItem> is an array containing between two and four elements. The elements in this array define the menu item to insert. For more information about the elements in this array, see the :addItem()) method.

This method returns the value .T. (true) when a menu item could be inserted, otherwise it returns .F. (false).


The :insItem() method inserts menu items into an existing menu object. This allows the menu to be dynamically changed at runtime. This is seldom used, since the user interface is rarely changed at runtime. The structure of the <aItem> parameter is the same as that for the :addItem() method (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.