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>
  1. topmenu-attribute defines a property of the TopMenu.
  2. group-attribute defines a property of a TopMenuGroup.
  3. command-attribute defines a property of a TopMenuCommand.
  4. 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.