MENU Element

Syntax

<MENU
  NUMCOLUMNS="numcolumns"
  CENTER="center"
  NUMBERS="numbers"
  HOVER="hover"
  SHOWSTATES="showstates"
  DONEITEMS="doneitems">
  ...
</MENU>

Attributes

NUMCOLUMNS

The number of columns which the menu items should be displayed in. Defaults to 1.

CENTER

If set to "1", the menu items will be centered within their column. Defaults to not centered.

NUMBERS

If set to "1", the menu items will be numbered. Defaults to not displaying numbers.

HOVER

TQS 2.1 If set to "U", a menu item will be underlined when the mouse hovers over it. Defaults to not underlining.

SHOWSTATES

TQS 2.5 If set to "1", each menu item will have the state image for the target location displayed next to it.

DONEITEMS

TQS 2.5 Specifies how to handle menu items whose target locations' states are "DONE" or "DONE100". Defaults to "SHOW", where menu items are displayed as normal on the menu. Other values include "HIDE", where such items are not displayed, and "DISABLE", where items are displayed but cannot be selected.

Placement

The MENU element must be a child of a LOC element whose TYPE attribute is set to "MENU", or of the GLOBAL element when specifying settings for all MENU locations.

Children

The following child elements are supported:

• INSTR
• MENUITEM (when not located inside the GLOBAL element)

Remarks

In TQS 2.0 global settings, only the element's INSTR subelement is used; attributes are ignored. In version 2.1 and later, all MENU attributes are supported under global settings.

For more information on TQS's state tracking and scoring capabilities, read the TQS Tutorial, Part XIII.

Examples

<GLOBAL>
  <MENU
    CENTER="1"
    HOVER="U">
    <INSTR>Instructions for all menus here</INSTR>
  </MENU>
</GLOBAL>

<LOC TYPE="MENU">
  <MENU
    CENTER="0"
    NUMCOLUMNS="2"
    NUMBERS="1">
    <INSTR>Choose a chapter from below.</INSTR>
    <MENUITEM .../>
    <MENUITEM .../>
    <MENUITEM .../>
    ...
  </MENU>
</LOC>