The Gauge control displays a numerical value using a speedometer style indicator. Its value is typically set by commands received from a connected device. You can attach up to four labels to the gauge which can be used to display units and status information. The first label can display the current gauge value as a number. Parts of the gauge scale can be marked using colored bands to indicate target or out-of-range values on the scale.
The gauge value is a floating point number.
|MinValue||Design-only||Single||SetMinimum||The minimum value shown on the gauge scale|
|MaxValue||Design-only||Single||SetMaximum||The maximum value shown on the gauge scale|
|Name||Read only||string||–||The name of the control|
|ScaleLinesMajorStepValue||Design-only||Single||–||The interval between numbered major-ticks on the scale|
|ScaleLinesMinorTicks||Design-only||Integer||–||The number of unnumbered ticks between numbered major-ticks on the scale|
|ScaleNumbersFormat||Design-only||String||–||The format for numbers shown on the scale|
|BaseArcStart||Design-only||Integer||–||The angle where the scale begins. Relative to an analog clock, 0 would be at 3 o’clock; 90 would be at 6 o’clock; 180 would be at 9 o’clock and 270 would be at 12 o’clock.|
|BaseArcSweep||Design-only||Integer||–||The length of the scale arc, in degrees. 180° is half a circle; 270° is three-quarters of a circle|
|GaugeAutoScale||Design-only||bool||–||When true, the gauge automatically resizes to fit the control rectangle|
|DisplayValueOnLabel||Design-only||bool||–||When true, the gauges current value is displayed on the first label|
|GaugeLabels||Design-only||Collection||–||A collection of labels attached to the gauge|
|Label0, Label1, Label2, Label3||Read/Write||string||SetGaugeLabel||Get/set the current value for a gauge label, if the label is present in the GaugeLabels collection.|
|GaugeRanges||Design-only||Collection||–||A collection of colored bands attached to the scale|
|Value||Read/write||float||SetNumber||The current value|
This control also supports all the common control properties.
Labels can be included to display text on the gauge. Labels can be static (showing units, for example) or dynamically display the current gauge value. They can also be changed by sending serial commands to the interface panel from your Arduino sketch.
Use the ellipsis control (…) on the
GaugeLabels property to open the label collection editor. The collection editor lets you add, remove and edit the labels attached to the gauge. Each label is positioned relative to the center of the gauge with positive values moving the label down and to the right.
The first label shows the current gauge value when the gauge control’s
DisplayValueOnLabel is true. You must still create and position at least one gauge label to display the gauge value when
DidsplayValueOnLabel is true.
SetGaugeLabel(ControlName, LabelIndex, LabelText) to change the label text from your Arduino sketch.
Gauge ranges provide a way to highlight different regions of the gauge scale with different colors. These regions could indicate normal and abnormal ranges for the measurement shown.
Use the ellipsis control(…) on the
GaugeRanges property to open the range collection editor. The collection editor lets you add, remove and edit the colored range bars attached to the gauge scale. Each band includes a
Color property and
End properties which set the portion of the scale that is colored.