Special Properties

HIGH-COLOR (numeric)

In order to draw the 3-D effects, the runtime requires three related colors: the background color, and lighter and darker versions of that color. The HIGH-COLOR property specifies the color number of the brighter color. The LOW-COLOR property specifies the color number of the darker color. If either of these values is zero, the runtime will attempt to find default values. The runtime knows how to find colors for the low-intensity versions of blue, green, cyan, red, magenta, brown, and white (out of the default palette). If the background color is not one of these colors, and either the HIGH-COLOR or LOW-COLOR is zero (0), the 3-D effect will be ignored.

LOW-COLOR (numeric)

This property supplies the color number of the darker version of the background color used to draw the 3-D styles. See HIGH-COLOR for a complete description.

FILL-COLOR (numeric)

This property establishes a color that fills a frame's interior. The color values range from 1 to 16. A value of 0 (the default) indicates that the frame should have no fill color. The color acts like a background color in terms of how color modification settings affect it. (Note that the control's background intensity setting can also affect this color.) For a borderless colored area, make the frame's color and the fill color the same.

The specified fill color is used in the borders of the RAISED and ENGRAVED styles, but not in the borders of the other 3-D styles. Note that the frame's title establishes its own background color, which is visible only if it is not the same as the fill color. We recommend that you do not insert titles on filled frames. (An exception is interior titles; see the TITLE-POSITION property below.)

FILL-PERCENT (numeric)

This property allows you to fill a portion of a frame with the fill color. The property's value is the percentage of the frame filled, from 0 to 100. If the frame is taller than it is wide (in base units), then the fill color is applied from the bottom of the frame up to the specified percentage. Otherwise, the frame is filled with the indicated percentage of fill color from left to right. You can use this property to create a progress (or status) bar. The default value for this property is 100.

FILL-COLOR2 (numeric)

This property has the same range of values (1 - 16) as FILL-COLOR but is used only if the value of FILL-PERCENT is less than 100. The color specified by this property is applied to the part of the frame that is not filled by FILL-COLOR. If the value of FILL-COLOR2 is 0 (the default), then no color is applied to the part of the frame not already filled by FILL-COLOR.

TITLE-POSITION (numeric)

This property determines the position of the frame's title, as follows:

1 Top left
2 Top center
3 Top right
4 Bottom left
5 Bottom center
6 Bottom right
7 Centered vertically and horizontally

Unless the FULL-HEIGHT style (described above) is in effect, a TITLE-POSITION value of 1, 2, or 3 places the top of the frame half a character lower than the specified position. A TITLE-POSITION value of 4, 5, or 6 places the bottom of the frame half a character higher than the specified position. With values 1 - 6, the frame's title appears centered with respect to the frame's border.

TITLE-POSITION value 7 does not adjust the border position as described above, nor does it have a background color. As a result, it can be used with FILL-COLOR and FILL-PERCENT.