TQS Home
Trivia Quiz Shell Version 2.8 Now Available!Bot Productions Home
 
TQS 2.5

Back to Reference

STATEIMG Element

Specifies image files or colors that are used to display the state of a location.

Syntax
<STATEIMG
  EMPTY="empty"
  PARTIAL="partial"
  DONE="done"
  DONE100="done100"
  BGCOLOR="bgcolor"
  FRAMECOLOR="framecolor"
  EMPTYCOLOR="emptycolor"
  PARTIALCOLOR="partialcolor"
  DONECOLOR="donecolor"
  DONE100COLOR="done100color"
/>
Attributes
EMPTY
The name of the image file representing the "EMPTY" state, where a location has not been visited.
PARTIAL
The name of the image file representing the "PARTIAL" state, where a location has been visited but not completed.
DONE
The name of the image file representing the "DONE" state, where a location has been completed.
DONE100
The name of the image file representing the "DONE100" state, where a location has been completed with a score of 100%.
BGCOLOR
TQS 2.8 The color to use for the inner background of state images. Defaults to "#000033".
FRAMECOLOR
TQS 2.8 The color to use for the one-pixel frame around the state image background. Defaults to "white".
EMPTYCOLOR
TQS 2.8 The color to use for the "EMPTY" state image. Currently, no image is displayed for this state, so this attribute is ignored.
PARTIALCOLOR
TQS 2.8 The color to use for the "PARTIAL" state image, which is currently an image of the letter P. Defaults to "white".
DONECOLOR
TQS 2.8 The color to use for the "DONE" state image, which is currently an image of a check mark. Defaults to "yellow".
DONE100COLOR
TQS 2.8 The color to use for the "DONE100" state image, which is currently an image of a star. Defaults to "yellow".
Placement

The STATEIMG element must be a child of the GLOBAL element.

Children

No children are supported within the STATEIMG element.

Remarks

If images are specified, they take precedence over any specified colors.

Color values can either be words ("white", "blue") or hexadecimal values ("#FFFFFF", "#0000FF"). Also, you may use the empty string "" to signify that the particular portion of the state image should not be drawn. View the list of Internet Explorer's named colors.

Currently, when printing a report, any specified color values are ignored and the default state images are used instead.

Image files must reside in the data root folder. This is, by default, the folder containing the .TQS file.

  • The data root folder can be set with the TQS element's DATAROOT attribute. To specify an absolute path, such as an Internet address, precede the path with NOROOT?.
  • TQS 2.6 To specify an embedded file, precede the path with EMBED?.

State images can be displayed in menus and/or in the report screen.

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

Examples

<STATEIMG
  EMPTY="custom_empty.gif"
  PARTIAL="custom_partial.gif"
  DONE="custom_done.gif"
  DONE100="custom_done100.gif"
/>
<STATEIMG
  BGCOLOR=""
  FRAMECOLOR="blue"
  PARTIALCOLOR="white"
  DONECOLOR="red"
  DONE100COLOR="#ff1192"
/>


©2016 Bot Productions. All rights reserved.Last Updated: September 9, 2007