HANGMAN Element

Syntax

<HANGMAN
  INORDER="inorder"
  REPLACEIMG="replaceimg"
  IMGPOS="imgpos"
  CHARSET="charset"
  SHOWSCORE="showscore"
  IMGBASECOLOR="imgbasecolor"
  IMGBODYCOLOR="imgbodycolor">
  ...
</HANGMAN>

Attributes

INORDER

If set to "1", the words/phrases will be presented to the user in the order that the WORD elements are listed in the file. Defaults to random order.

REPLACEIMG

TQS 2.1 If set to "1", TQS will not use its built-in hangman graphics. Instead, it will use the images specified by the child IMG elements. There must be at least two child IMG elements for this setting to take effect.

TQS 2.8 If set to "0", the built-in graphics will be used. This can be used in a location to override REPLACEIMG specified at the global level.

IMGPOS

TQS 2.1 If set to "LEFT", TQS will display the hangman graphics to the left of the word and letter table. If set to "RIGHT" or if not specified, graphics will be on the right.

CHARSET

TQS 2.1 The set of characters that the user can guess. These characters are choices in the table of letters, and all occurrences of these characters in hangman words will be replaced with a "-". The default character set is the 26-letter English alphabet, capital letters only.

SHOWSCORE

TQS 2.5 If set to "1", TQS will display score statistics for the current location, such as number tried, correct, wrong, and percent correct. Defaults to being hidden.

IMGBASECOLOR

TQS 2.8 The color to use when drawing the hangman gallows. Defaults to "white". Ignored if replacement images are specified.

IMGBODYCOLOR

TQS 2.8 The color to use when drawing the hangman body. Defaults to "red". Ignored if replacement images are specified.

Placement

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

Children

The following child elements are supported:

• WORD (when not located inside the GLOBAL element)
• IMG TQS 2.1
• CORRECT TQS 2.5
• INCORRECT TQS 2.5

Remarks

In TQS 2.0, there are no global settings for the hangman location type. In versions 2.1 and later, all attributes, as well as the IMG subelements, are supported in global settings.

Regardless of the characters specified by the CHARSET attribute, only the 26 letters of the English alphabet can be selected from the letter table using the keyboard.

Note: In TQS, all special characters must be encoded using their numerical value. For example, to display the Ü character, you must use Ü instead of Ü.

Examples

<GLOBAL>
  <HANGMAN
    REPLACEIMG="1">
    <IMG SRC="hang1.gif"/>
    <IMG SRC="hang2.gif"/>
    ...
  </HANGMAN>
</GLOBAL>

<LOC TYPE="HANGMAN">
  <HANGMAN
    INORDER="1"
    IMGPOS="LEFT"
    CHARSET="ABCDEFGHIJKLMNOPQRSTUVWXYZ&#196;&#214;&#220;">
    <WORD>ICH H&#196;TTE DAS GERN</WORD>
  </HANGMAN>
</LOC>

<HANGMAN
  IMGBASECOLOR="blue"
  IMGBODYCOLOR="green">
  ...
</HANGMAN>