Syntax of a topmenu file (.4tm)

A topmenu file defines a tree of menu options to be displayed in the header of a window.

Topmenu XML syntax

<TopMenu [ topmenu-attribute="value" [...] ] >
    group
    [...]
  </TopMenu>

where group is:

<TopMenuGroup group-attribute="value" [...]>
    { <TopMenuSeparator separator-attribute="value" [...] />
    | <TopMenuCommand command-attribute="value" [...] />
    | group
    } [...]
  </TopMenuGroup>

topmenu-attribute defines a property of the TopMenu.
group-attribute defines a property of a TopMenuGroup.
command-attribute defines a property of a TopMenuCommand.
separator-attribute defines a property of a TopMenuSeparator.

Topmenu XML attributes

Table 1. TopMenu node attributes
Attribute	Type	Description
`name`	`STRING`	Identifies the topmenu.
`style`	`STRING`	Can be used to decorate the element with a presentation style.
`tag`	`STRING`	User-defined attribute to identify the node.

Table 2. TopMenuCommand node attributes
Attribute	Type	Description
`name`	`STRING`	Identifies the action corresponding to the topmenu command. Can be prefixed with the sub-dialog identifier.
`style`	`STRING`	Can be used to decorate the element with a presentation style.
`tag`	`STRING`	User-defined attribute to identify the node.
`text`	`STRING`	The text to be displayed in the pull-down menu option.
`comment`	`STRING`	The message to be shown for this element.
`hidden`	`INTEGER`	Indicates if the command is hidden.
`image`	`STRING`	The icon to be used in the pull-down menu option.
`acceleratorName`	`STRING`	Defines the accelerator name to be display on the left of the menu option text. Note this attribute is only used for decoration (you must also define an action default accelerator).

Table 3. TopMenuGroup node attributes
Attribute	Type	Description
`name`	`STRING`	Identifies the topmenu group.
`style`	`STRING`	Can be used to decorate the element with a presentation style.
`tag`	`STRING`	User-defined attribute to identify the node.
`text`	`STRING`	The text to be displayed in the pull-down menu group.
`comment`	`STRING`	The message to be shown for this element.
`hidden`	`INTEGER`	Indicates if the group is hidden.
`image`	`STRING`	The icon to be used in the pull-down menu group.

Table 4. Separator-attributes for the TopMenuSeparator node
Attribute	Type	Description
`name`	`STRING`	Identifies the topmenu separator.
`style`	`STRING`	Can be used to decorate the element with a presentation style.
`tag`	`STRING`	User-defined attribute to identify the node
`hidden`	`INTEGER`	Indicates if the separator is hidden.