MWAPI - CHOICE

Draft MDC Standard

CHOICE specifies, via descendant nodes identified by item subscripts, the text to be displayed for choices. The sequence of choices is determined by the collating sequence of their item, ritem, and citem subscripts, beginning at the edge closest to the origin.

For a table gadget, the value of an entry of the form

^$W[INDOW] ( wname , gkeyword , gname , ckeyword , ritem , citem)

specifies the text that appears for the cell identified by the ritem and citem subscripts for the gadget identified by gname.

The ritem subscript identifies a row. If there is no such row, it is created.

The citem subscript identifies a column. If there is no such column, it is created.

For gadget types other than table, the value of an entry of the form

^$W[INDOW] ( wname , gkeyword , gname , ckeyword , item )

specifies the text that appears for the choice identified by item for the gadget identified by gname.

For a menu, the value of an entry of the form

^$W[INDOW] ( wname , mkeyword , mname , ckeyword , item )

specifies the text that appears for the choice identified by item for the menu identified by mname.

No value is present at the level of the CHOICE elattribute itself.

For a menu or radio button set, if the value of a descendant node of the CHOICE elattribute contains a mnemonichar, the character following the mnemonichar is a mnemonic character that may enable the user, via the keyboard, to select the choice. The mnemonichar is not displayed. If two mnemonichars are immediately adjacent within a CHOICE value, no mnemonic character is defined and a single mnemonichar appears in the displayed choice text. The character mnemonichar cannot itself be used as a mnemonic character.