# JCString Properties

Alignment · Color · Fonts · Horizontal and Vertical Spacing

Hypertext · Images · Reset · Strikethrough Text · Underlined Text

Most JClass BWT components support a rich text format called "JCString", which allows a mixture of hypertext, images and text within BWT components. Text can also appear in a variety of colors, fonts and styles, including underline and strikeout.

The following section describes the types of JCString properties available, and provides examples of their use.

### Alignment

If a cell contains an image, the line height can, in some cases, be greater than the height of the text. Text can be aligned vertically using the `ALIGN` property. Valid values include `TOP`, `BOTTOM` and `MIDDLE`. The following example uses all three possible `ALIGN` values:

    ([IMAGE=smiley.gif][ALIGN=TOP]top
    [IMAGE=smiley.gif][ALIGN=MIDDLE]middle
    [IMAGE=smiley.gif][ALIGN=bottom]bottom)

### Color

Different text colors can be specified by using the `COLOR` property. The JCString shown below displays text using red, green and blue colors.

    ([COLOR=red]Red, [COLOR=green]Green, [COLOR=blue]Blue, [DEFAULT_COLOR]Default)

In addition to these colors, any color referenced in can be used, including RGB color values.

Note: The property `DEFAULT_COLOR` resets the text color in the rest of the table to the browser's regular text color.

### Fonts

Different fonts can be specified within a single cell or label by using the `FONT` property. The following JCString example displays text using a variety of fonts and font styles.

    ([FONT=timesroman-plain-20]TimesRoman-20,
     [FONT=timesroman-bold-12]TimesRoman-12 bold,
     [DEFAULT_FONT]Default)

Note: The property `DEFAULT_FONT` resets the fonts in the rest of the table to the browser's regular font.

### Horizontal and Vertical Spacing

Vertical and horizontal spacing can be modified by using the `VERT_SPACE` and `HORIZ_SPACE` tags. `VERT_SPACE` offsets the current line by a number of pixels, and `HORIZ_SPACE` offsets the line from the margin by a set number of pixels. The example below makes use of the `HORIZ_SPACE` and `VERT_SPACE`. tags.

    ([VERT_SPACE=10]Vertical offset=10
     [HORIZ_SPACE=10] Horizontal offset=10)

### Hypertext

Hypertext links can be specified within a cell. The link appears underlined, and the browser display will show the target URL when the mouse cursor passes over the linked text. Hypertext uses the HREF property, and `trackCursorPosition` must be set to `true` in order for the link to work. The example below links to KL Group's home page:

    Click [HREF=http://www.klg.com]here[/HREF] for tech support)

### Images

Images can be specified in a cell by using the `IMAGE` property. An URL or file name must be provided. If a relative path is given, the document base for the page is assumed.

The example below mixes an image with text:

    (Tech Support: [IMAGE=
    http://www.klg.com/images/technical.gif])

### Reset

The `RESET` property resets the font and color to the default value used by the browser. The following example changes the `COLOR` and `FONT` values back to the default:

    ([COLOR=green][FONT=timesroman-plain-20]Big text
    [RESET]Regular Text)

### Strikethrough Text

Text can be crossed-out using the `STRIKEOUT` property. The following incorporates text that has been stuck through:

    (This text is [ST]crossed-out[/ST].)

### Underlined Text

Text can be underlined using the JCString `UNDERLINE` property. The following example incorporates underlined text:

    (This text is [UL]underlined[/UL].)