NewMenu

int NewMenu (int menuBarHandle, char menuName[], int beforeMenuID);

Purpose

Adds a new menu to a menu bar and returns a menu ID that you can use to specify the menu in subsequent function calls.

Parameters

Input
Name Type Description
menuBarHandle integer Specifier for a particular menu bar that is currently in memory. You obtain this handle from LoadMenuBar or NewMenuBar.

If the menu bar was automatically loaded through LoadPanel, use GetPanelMenuBar to get the menu bar handle.
menuName string New menu name to add to the menu bar.

To add an underline accelerator to a menu name, precede the letter to underline with two underscores; for example, __File.
beforeMenuID integer ID of the menu above which to insert the new menu. To place the new menu at the end of the menu bar, pass –1.

Return Value

Name Type Description
menuID integer ID you use to reference the menu in subsequent function calls. Negative values indicate that an error occurred. Zero is not a valid ID.

Code Error Message String
xx Success