Skip to main content

Full Circular Scales

  • 2 minutes to read

In the Gauge control, the Full Circular scales are implemented as the TdxGaugeCircularScale and TdxGaugeDBCircularScale objects, corresponding to the unbound and data-aware scale versions, respectively:

Since full circular scales impose no limitations on disposition of their ranges, you can assign any values to the starting and ending angles of the scale’s range of displayed values. If the starting angle is less than the ending angle, the scale’s range lies in the counter-clockwise direction. Otherwise, it is a clockwise scale:

You can customize both the disposition and direction of the range of displayed values by assigning different values to the OptionsView.AngleStart and OptionsView.AngleEnd properties in various combinations. The range of displayed values can occupy any portion of the full circular scale arc:

OptionsView Parameter Values

Scale’s Appearance

AngleStart = 0

AngleEnd = 180

AngleStart = 180

AngleEnd = 0

AngleStart = 0

AngleEnd = -180

AngleStart = -180

AngleEnd = 0

AngleStart = 230

AngleEnd = -20

AngleStart = -40

AngleEnd = 160

Full circular scales are specifically designed to imitate speedometers, tachometers, clocks, stopwatches and other analog measuring instruments with the full-circular scale. To loop the range of displayed values by placing it along the full-circular scale’s arc, one of two range position angles must exceed the other by 360 degrees. As with non-cycled scales, if the AngleStart property value is greater than the AngleEnd property value, the scale’s range is directed clockwise. Otherwise, it is a counter-clockwise full-circular looped scale. To avoid possible tick mark label overlapping, you can hide either the scale range starting or ending tick mark with its label inscription by using the ShowFirstTick or ShowLastTick property, respectively: