Added May 2011

When deleting a built-in menu, you can now set the menuid parameter to "" and put either the string representation of the internal menu id # in the mnutxt parameter, or the numeric value in the itemid parameter (in which case set mnutxt=""). The latter method apparently seems more natural to some users, whose efforts were previously failing.

AG_MENU supports simplified deletion of menu items using either of the following formats:

TAB(-10,AG_MENU);"3,,";str(IDM_PRINTS);chr(127);

TAB(-10,AG_MENU);"3,";MENUID$;",";MNUTXT$;chr(127);

The first example works for internal (built-in) menu items, where you must specify the str() of the IDM_xxx value for the menu (from ashell.def).

The second example works for custom menu items, where you specify the text of the parent menu and the text of the item to delete.

These formats are mainly useful with AGCMD.LIT, since they don't apply to AUI_MENU. They are faster than any other method for deleting individual items one at a time, since there is no return status.