Gauge control properties

Edit online

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 that is associated with it and select a color from the Palette tab that appears.
`BackgroundPicture`	To add or change an image that appears as the background for the control, click the Ellipses button that is associated with it and open a bitmap file.
`Caption`	To insert a caption to show in the center of the Gauge control, type your text in the field that is associated with it. 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 that is associated with it and select a color from the Palette tab that appears.
`CaptionFont`	To change the font for your caption text, click the Ellipses button that is associated with it and select a font from the Font window that appears. 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 field that is associated with it. The default value is `2`.
`EnclosingCircleColor`	To change the background color for the control, click the drop‑down arrow that is associated with it and select a color from the Palette tab that appears.
`EndAngle`	To change the angle of the scale on the high end of the control, change the value in the respective field. The value widens or shrinks 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 respective field. The default value is `3`.
`ForeColor`	To change the foreground color, click the drop‑down arrow that is associated with it and select a color from the Palette tab that appears.
`GreenColor`	To change the color (typically green) of the OK area of the control, click the drop‑downarrow that is associated with it and select a color from the Palette tab that appears.
`GreenStartValue`	To change the beginning value for the OK area on the control, change the value in the respective field. The default value is `60`.
`IndexColor`	To change the color of the needle indicator for the control, click the drop‑down arrow that is associated with it and select a color from the Palette tab that appears.
`IndexLineThickness`	To change the thickness of the needle indicator for the control, change the value in the respective field. The default value is `0`.
`InternalCircleThickness`	To change the thickness of the internal circle of the control, change the value in the respective field. The default value is `2`.
`MaximumValue`	To change the maximum value for the control, change the value in the respective field. The default value is `100`.
`MinimumValue`	To change the minimum value for the control, change the value in the respective field. The default value is `0`.
`NumberColor`	To change the color of the numbers on the control, click the drop‑down arrow that is associated with it and select a color from the Palette tab that appears.
`NumberFont`	To change the font for the numbers on the control, click the Ellipses button that is associated with it and select a font from the Font window that appears. The default value is `Arial`.
`NumberOfDivisions`	To change the number of major division lines (tick markers) for the control, change the value in the respective field. 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 respective field. The default value is `2`, which means one minor tick marker appears 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‑downarrow that is associated with it and select a color from the Palette tab that appears.
`RedStartValue`	To change the beginning value for the Warning area on the gauge, change the value in the respective field. The default value is `90`.
`RelativeCaptionX`	To change the relative X coordinate (east or west) of the text that is entered for `Caption`, change the value in the respective field. The default value is `0.5`.
`RelativeCaptionY`	To change the relative Y (north or south) coordinate of the text that is entered for `Caption`, change the value in the respective field. The default value is `0.5`.
`RelativeCenterX`	To change the relative center Y coordinate of the control, change the value in the respective field. The default value is `0.5`.
`RelativeCenterY`	To change the relative center X coordinate of the control, change the value in the respective field. The default value is `0.55`.
`RelativeEnclosingCircleRadius`	To change the relative enclosing circle radius of the control, change the value in the respective field. The default value is `.98`.
`RelativeExternalRadius`	To change the relative external radius of the control, change the value in the respective field. 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 respective field. The default value is `0.3`.
`RelativeIndexLength`	To change the relative length of the needle indicator from the front (pointy) end, change the value that is associated with it. 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 respective field. The default value is `0.35`.
`RelativeTextRadius`	To change the relative position of the text (scale numbers), change the value in the respective field. The default value is `1.1`.
`ScaleCircleColor`	To change the color of the scale circle, click the drop‑down arrow that is associated with it and select a color from the Palette tab that appears.
`StartAngle`	To change the position of the minimum value marker and the needle indicator, change the value in the respective field. The default value is `225`.
`StepValue`	To change the step value, change the value in the respective field. The default is `1`.
`SubdivisionLineThickness`	To change the thickness of the minor division lines (tick markers), change the value in the respective field. The default value is `1`.
`TailAngle`	To change the thickness of the needle indicator, change the value in the respective field. The default is `165`.
`Value`	To change the default value for the needle indicator, change the value in the respective field. The default value is `0`.
`ValueFormatString`	To change the value format of the scale number, change the value in the respective field. 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 that is associated with it and select a color from the Palette tab that appears.
`YellowStartValue`	To change the beginning value for the Caution area on the gauge, change the value in the respective field. The default value is `75`.