Template Format

A menu template has the following format:

Length (USHORT)

The length of the menu template.
Version (USHORT)
The template version. Versions 0 and 1 are valid.
Code page (USHORT)
The identifier of the code page used for the text items within the menu (but not any submenus, which each have their own code pages).
Item offset (USHORT)
The offset of the items from the start of the template, in bytes.
Count (USHORT)
The count of menu items.
Presentation parameters offset (USHORT)
Offset of presentation parameters from the start of the template, in bytes. This field is only present for version 1 of the template.
Menu Items
A variable-sized array of menu items as follows:

Style (USHORT)

Menu item styles (MIS_*; see Menu Item Styles) combined with the logical-OR operator.
Attributes (USHORT)
Menu item attributes (MIA_*; see Menu Item Attributes) combined with the logical-OR operator.
Item (USHORT)
An application-provided identifier for the menu item.
Variable data
Following the identifier is a variable data structure whose format depends upon the value of Style:

MIS_TEXT

Text (PSZ)

Null-terminated text string.
MIS_SUBMENU
A menu template structure.
MIS_BITMAP

Text (PCH)

Null-terminated text string.

For MIS_BITMAP menu items, the item text string can be used to derive the resource identifier from which a bit map is loaded. There are three instances:

• The first byte is null; that is, no resource is defined and it is assumed that the application subsequently provides a bit-map handle for the item.

• The first byte is 0xFF, the second byte is the low byte of the resource identifier, and the third byte is the high byte of the resource identifier.

• The first character is "#", and subsequent characters make up the decimal text representation of the resource identifier.
The resource is assumed to reside in the resource file of the current process.

If the string is empty or does not follow the format above, no resource is loaded.

---

[Back: Menu Template]
[Next: STRINGTABLE Statement]