# 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