INSERT MENU ITEM

version 6.0

INSERT MENU ITEM (menu; afterItem; itemText{; process})

The INSERT MENU ITEM command inserts new menu items into the menu whose number is passed in menu after the existing menu item whose number is passed in afterItem.

If you omit the process parameter, INSERT MENU ITEM applies to the menu bar for the current process. Otherwise, INSERT MENU ITEM applies to the menu bar for the process whose reference number is passed in process.

INSERT MENU ITEM allows to you insert one or several menu items in one call.

INSERT MENU ITEM works like APPEND MENU ITEM, except for the following differences:

• INSERT MENU ITEM enables you to insert items anywhere in the menu, while APPEND MENU ITEM always adds them at the end of the menu.

• With INSERT MENU ITEM, the item definition passed in itemText is limited to 255 characters, while with APPEND MENU ITEM, itemText is limited to 32,000 characters.

See the description of the APPEND MENU ITEM command for details about the the item definition passed in itemText.

Important: The new items do not have any associated method. Therefore, they must be managed from within a form method using the Menu selected command.

APPEND MENU ITEM.