Level indicator control properties

The following table lists the properties that appear on the Properties tab of the Control Properties window for a level indicator control.
Table 1. Level indicator control properties
Device Settings Explanation
BackColor 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.
CurrentValue To change the current (default) value for the control, change the value in the right column. The default is 20.
DrawTextLabels The default is True.
EnableThreshold1 To enable/disable the appearance of the top middle threshold level line, change the value in the right column. True enables the appearance; False disables it.

The default is True.

EnableThreshold2 To enable/disable the appearance of the bottom middle threshold level line, change the value in the right column. True enables the appearance; False disables it.

The default is True.

Font 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.
FormatString To change the value format of the scale numbers, 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.
GradientFactor To change the gradient factor for the control, change the value in the right column. The higher the number the more pronounced the gradient for the appearance of the knob, which displays as light to dark. The default value is 0.7.
HorizontalLayout To change the layout of the level indicator to be horizontal, change the value in the right column to True. The default is False.
LiquidColor To change the color of the level indicator, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
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.
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 5.

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 1, which means no 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.
RelativeDepth To change the appearance of the relative depth of the control, change the value in the right column. The default is 0.2.

For example, a value of 0 gives the control a flat tall rectangular appearance. While a value of 0.2 gives it a 3-dimensional cylindrical appearance.

The appearance of the level indicator control is also affected by SquareShape, RelativeHeight and RelativeWidth.

The appearance of the orientation of the level indicator is affected by HorizontalLayout.

RelativeHeight To change the relative height of the control, change the value in the right column. The default is 0.9.
RelativeWidth To change the relative width of the control, change the value in the right column. The default is 0.9.
ShadedAreaRelativeSize The default is 0.
SquareShape To change the appearance of the Level Indicator control to look like a 3-dimensional square, change the value in the right column to True. The default is False.
Threshold1Color To change the color of the top middle threshold level line, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
Threshold1Thickness To change the thickness of the top middle threshold level line, change the value in the right column. The default is 1.
Threshold1Value To change the position of the bottom middle threshold level line, change the value in the right column. The default is 75.
Threshold2Color To change the color of the bottom middle threshold level line, click the drop‑down arrow in the right column and select a color from the Palette tab that displays.
Threshold2Thickness To change the thickness of the bottom middle threshold level line, change the value in the right column. The default is 1.
Threshold2Value To change the position of the bottom threshold level line, change the value in the right column. The default is 35.
UseColorGradients The default is True.

Feedback