InsertMenu

Add a menu to the menu list

#include <Menus.h> Menu Manager

void InsertMenu(theMenu, beforeID );

MenuHandle theMenu ; handle of a menu to insert into the menu bar

short beforeID ; 0=at end of list; else is where to put menu

This places a menu into the menu list at a specified position or after all other

menus, or prepares a popup menu.

theMenu is the handle of a menu obtained via NewMenu or GetMenu. It

leads to a variable-length MenuInfo structure.

beforeID specifies where to put the menu in the menu list; it is a menuID

value from a previous call to NewMenu or the ID of a resource read

via GetMenu. Use beforeID =0 to put the menu at the end of the list

(the rightmost position on the menu bar).

Use beforeID = hierMenu (-1) to place a menu in the hierarchical

portion of the menu list, for use as a popup menu (see

PopUpMenuSelect) or as a submenu (attach to a menu item via

Notes: This is the normal way to install a prepared menu (obtained via GetMenu

or NewMenu) into the menu list. See NewMenu for an example of usage.

Note that after inserting the menu, it is still OK to insert or append items

to the individual menus; however, most applications tend to prepare the

menus before inserting them.

An alternative to this is to read and install a prepared menu list resource

(type 'MBAR') via GetNewMBar and SetMenuBar.

Use DeleteMenu to remove a menu from the menu list.

You may store any reasonable number of menus into the hierarchical

portion of the menu list by using beforeID = -1; then use them as popup

menus (PopUpMenuSelect) or "attach" one to an item as a submenu

(SetItemCmd). Be careful about assigning command-key equivalents to

popup menus and submenus since they will be searched (even when not

attached or not visible) upon calls to MenuKey.

Referenced by (46):