MENU Statement

Syntax:

  MENU menu-id  [load-option] [mem-option] [codepage]
  BEGIN
  menuitem-definition
      .
      .
      .
  END

The MENU statement defines the contents of a menu resource. A menu resource is a collection of information that defines the appearance and function of an application menu. A menu is a special input tool that lets a user choose commands from a list of command names. A menu resource can be loaded from the executable file when needed by using the WinLoadMenu function.

You can provide any number of MENU statements in a resource script file, but each statement must specify a unique menu-id value. You can provide any number of menuitem-definition statements in the menu. These define the submenus and menu items (commands) in the menu. The order of the statements defines the order of the menu items.

menu-id

Specifies the menu-resource identifier. This value must be an unsigned integer in the range of 1 through 65535, a simple expression that evaluates to a value in these ranges, or a character string.
load-option
Specifies when the system loads the resource from the executable file into memory. This value must be one of the following: PRELOAD
System loads the resource when the application starts.
LOADONCALL
System loads the resource when the application calls the WinLoadMenu function. This is the default option.
mem-option
Specifies how the system manages the resource when it is in memory. This value must be one or more of the following: FIXED
System keeps the resource at a fixed memory location.
MOVEABLE
System moves the resource as necessary to compact memory.
DISCARDABLE
System discards the resource if it is no longer needed. The default setting is MOVEABLE and DISCARDABLE.
codepage
Specifies a codepage value. For a list of valid code pages see CODEPAGE Statement.
menuitem-definition
Specifies a PRESPARAMS, MENUITEM, or SUBMENU statement. You can use one or more PRESPARAMS statements to control the appearance of a menu, such as the font and the foreground and background colors. If used, PRESPARAMS statements must be the first statements following the BEGIN keyword. For details about the PRESPARAMS statement, see PRESPARAMS Statement.

MENUITEM and SUBMENU statements define the individual commands or submenus in the given menu. For details about these statements, see MENUITEM Statement and SUBMENU Statement.

Example

This example creates a menu resource whose menu identifier is 1. The menu contains a menu item named Alpha and a submenu named Beta. The submenu contains two menu items, Item 1 and Item 2.

MENU 1BEGIN
    MENUITEM "Alpha", 100
    SUBMENU "Beta", 101
    BEGIN
        MENUITEM "Item 1", 200
        MENUITEM "Item 2", 201, , MIA_CHECKED
    END
END

---

[Back: LTEXT Statement]
[Next: MENUITEM Statement]