STATEIMG Element

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"
/>