MWAPI - TITLE

Draft MDC Standard

TITLE specifies text that appears within or adjacent to a gadget.

If the value of the TITLE elattribute contains a mnemonichar and the gadget is of a type that can get focus, the character following the mnemonichar is a mnemonic character that may enable the user, via the keyboard, to give focus to the gadget and the mnemonichar is not displayed. If two mnemonichars are immediately adjacent within a TITLE value, no mnemonic character is defined and a single mnemonichar appears in the displayed title text. The character mnemonichar cannot itself be used as a mnemonic character.

If the value of the TITLE elattribute contains a mnemonichar and the gadget is not of a type that can get focus, then if the gadget’s NEXTG elattribute is defined, focus is set according to the NEXTG value. If the gadget’s NEXTG elattribute is not defined, use of the mnemonichar does not cause focus to change.

If the TITLE elattribute of a radio button set contains a mnemonichar, the behavior resulting from use of the mnemonic character is platform specific.

In addition to giving focus to a gadget, use of a mnemonic character will cause any additional platform-specific behavior to occur.

For a check box gadget, TITLE specifies the text that appears adjacent to the selection area.

For a group frame gadget, TITLE specifies text that appears within or overlaying the frame.

For a label gadget, TITLE specifies the label text.

For a document, list box, list button, list entry box, long list box, radio button set, scroll, or text gadget, TITLE specifies text that appears adjacent to the gadget.

For a push button, TITLE specifies the text that appears on the button.