Gauge control properties

The following table lists the properties that appear on the Properties tab of the Control Properties window for a gauge control.

You can change the properties as follows:

Table 1. Gauge control properties
Device Settings Explanation
BackColor To change the back color for the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
BackgroundPicture To add/change an image that displays as the background for the control, click the Ellipses button in the right column and open a bitmap file.
Caption To insert a caption to show in the center of the Gauge control, type your text in the right column.

You can use RelativeCaptionY, RelativeCaptionX, RelativeCenterY, and RelativeCenterX to position the caption somewhere on the gauge other than its center.

CaptionColor To change the color for your caption text, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
CaptionFont To change the font for your caption text, click the Ellipses button in the right column and select a font from the Font window that displays. The default value is Arial.
DivisionLineThickness To change the thickness of the major division lines (also known as tick markers), change the value in the right column. The default value is 2.
EnclosingCircleColor To change the background color for the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
EndAngle To change the angle of the scale on the high end of the control, change the value in the right column. The value widens (lower value) or shrinks (higher value) the empty space between the low and high ends of the control. The default is -45.
ExternalCircleThickness To change the thickness of the external circle of the control, change the value in the right column. The default value is 3.
ForeColor To change the foreground color, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
GreenColor To change the color (typically green) of the OK area of the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
GreenStartValue To change the beginning value for the OK area on the control, change the value in the right column. The default value is 60.
IndexColor To change the color of the needle indicator for the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
IndexLineThickness To change the thickness of the needle indicator for the control, change the value in the right column. The default value is 0.
InternalCircleThickness To change the thickness of the internal circle of the control, change the value in the right column. The default value is 2.
MaximumValue To change the maximum value for the control, change the value in the right column. The default value is 100.
MinimumValue To change the minimum value for the control, change the value in the right column. The default value is 0.
NumberColor To change the color of the numbers on the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
NumberFont To change the font for the numbers on the control, click the Ellipses button in the right column and select a font from the Font window that displays. The default value is Arial.
NumberOfDivisions To change the number of major division lines (tick markers) for the control, change the value in the right column. The default value is 10.

For example, with the maximum value set at 100, minimum value at 0, and division at 5, your control would show major tick markers at 0, 20, 40, 60, 80, and 100.

NumberOfSubdivisions To change the number of minor division lines (tick markers) between two major ones, change the value in the right column. The default value is 2, which means one minor tick marker displays between two major tick markers. For example, to make three subdivision areas appear between two major markers, enter a value of 3.
RedColor To change the color (typically red) of the Warning area of the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
RedStartValue To change the beginning value for the Warning area on the gauge, change the value in the right column. The default value is 90.
RelativeCaptionX To change the relative X coordinate (east/west) of the text entered for Caption, change the value in the right column. The default value is 0.5.
RelativeCaptionY To change the relative Y (north/south) coordinate of the text entered for Caption, change the value in the right column. The default value is 0.5.
RelativeCenterX To change the relative center Y coordinate of the control, change the value in the right column. The default value is 0.5.
RelativeCenterY To change the relative center X coordinate of the control, change the value in the right column. The default value is 0.55.
RelativeEnclosingCircleRadius To change the relative enclosing circle radius of the control, change the value in the right column. The default value is .98.
RelativeExternalRadius To change the relative external radius of the control, change the value in the right column. The default value is 1.1.
RelativeIndexBackLength To change the relative length the needle indicator from the back (not pointy) end, change the value in the right column. The default value is 0.3.
RelativeIndexLength To change the relative length of the needle indicator from the front (pointy) end, change the value in the right column. Changing this value lengthens the needle indicator at its back (wider) end. The default value is 1.2.
RelativeInternalRadius To change the relative internal radius of the control, change the value in the right column. The default value is 0.35.
RelativeTextRadius To change the relative position of the text (scale numbers), change the value in the right column. The default value is 1.1.
ScaleCircleColor To change the color of the scale circle, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
StartAngle To change the position of the minimum value marker and the needle indicator, change the value in the right column. The default value is 225.
StepValue To change the step value, change the value in the right column. The default is 1.
SubdivisionLineThickness To change the thickness of the minor division lines (tick markers), change the value in the right column. The default value is 1.
TailAngle To change the thickness of the needle indicator, change the value in the right column. The default is 165.
Value To change the default value for the needle indicator, change the value in the right column. The default value is 0.
ValueFormatString To change the value format of the scale number, change the value in the right column. The default value is %.0f, which shows numbers, for example, as 0, 10, 20, and so on. For the value %.1f, the control would show number as 0.0, 10.0, 20.0, and so on.
YellowColor To change the color (typically yellow) of the Caution area of the control, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
YellowStartValue To change the beginning value for the Caution area on the gauge, change the value in the right column. The default value is 75.

Feedback