Menu Item Statements

MENUITEM statements are used in the item-definition section of a MENU statement to define the names and attributes of the actual menu items. Any number of statements can be given; each defines a unique item. The order of the statements defines the order of the menu items.

Note: The MENUITEM statements can only be used within an item-definition section of a MENU statement.

 ──MENUITEM─────────────────────────────────

 ─┬──string──,┬────┬,┬──────┬─,┬──────────┬┬
   │           └cmd─┘ └styles┘  └attributes┘│
   │                                        │
   └───────────────────SEPARATOR────────────┘

string (PCH)

A string, enclosed in double quotation marks, specifying the text of the menu item.

To insert a double-quote character (") in the text, use two double-quote characters ("").

If the styles parameter does not contain MIS_TEXT, the string is ignored but must still be specified. An empty string ("") should be specified in this instance.

To indicate the mnemonic for each item, insert the tilde character (~) in the string preceding the mnemonic character.

For MENUITEM statements within a SUBMENU (that is, pull-down menus) text may be split into a second column with an alignment substring. To right-align items insert "\a" in the text where alignment should begin. To left-align a second column of text insert "\t" in the text where alignment should begin. For each SUBMENU the longest item in the second column determines the width of that column. Only one alignment substring should be used in a menu item.

cmd (USHORT)
The value of the WM_COMMAND, WM_HELP, or WM_SYSCOMMAND message generated by the item when it is selected. It identifies the selection made and should be unique within one menu definition.
styles (USHORT)
One or more menu options defined by the MIS_* constants, ORed together with the "|" operator. For definitions of the MIS_* constants, see Menu Item Styles.
attributes (USHORT)
One or more menu options defined by the MIA_* constants, ORed together with the "|" operator. For definitions of the MIA_* constants, see Menu Item Attributes.

The style MIS_SUBMENU must not be used with this statement. See Submenu Statements for the SUBMENU statement.

Examples:

MENUITEM  "Alpha", 1, MIS_TEXT,MIA_ENABLED|MIA_CHECKED,'A'
MENUITEM  "Beta", 2, MIS_TEXT,,'B'

---

[Back: MENU Statement]
[Next: Submenu Statements]