Gauge

The gauge object is a circular dial with a needle and range of values that represent a traditional meter or dial. The gauge’s needle moves around the dial indicating the changing value.
Define the properties for the gauge object from the
Properties
window. For the gauge object, define properties for
Action
,
Color
,
Displacement
,
Size
,
Text
, and
Visibility
. The gauge object also has frame and object-specific properties:
Property
Description
Frame Color
Color for the frame of the object. Possible colors are custom, web, and system colors.
Frame Width
Width of the frame for the object. Possible values are literal values.
Background Shape
Shape of the measuring object. Possible shapes are rectangle, ellipse, hexagon, and octagon.
Indicator Color
Color for the interior of the indicator. Possible colors are custom, web, and system colors.
Indicator Constant Length
The indicator maintains the same length when traveling along the scale of the measuring object. Possible values are True or False.
Indicator Frame Color
Color for the outline of the indicator. Possible colors are custom, web, and system colors.
Indicator Frame Width
Width of the outline for the indicator. Possible values are literal values.
Indicator Thickness
Width of the indicator. Possible values are literal values.
Indicator Value
Initial value of the measuring object. Possible values are literal values.
Indicator Value Variable
Variable that controls the indicator of the measuring object. Possible variable data types are DINT or REAL. Click isv_a1 to select a variable.
Margin Bottom Right
Margin from the gauge dial to the bottom and right sides of the object perimeter. Possible values are literal values.
Margin Top Left
Margin from the gauge dial to the top and left sides of the object perimeter. Possible values are literal values.
Maximum
Maximum value of the scale on the measuring object. Possible values are literal values.
Minimum
Minimum value of the scale on the measuring object. Possible values are literal values.
Scale Frame Color
Color of the scale on the measuring object. Possible colors are custom, web, and system colors.
Scale Frame Width
Width of the scale on the measuring object. Possible values are literal values.
Scale Label Distance
Distance between the scale on the measuring object and the displayed range values, in pixels. Possible values are literal values.
Scale Label Frequency
Frequency of labeling of major divisions on the scale of the measuring object. For example, a value of two (2) results in labeling every second major division. Possible values are literal values.
Scale Label Style
Location of the displayed labels in reference to the circular scale. Possible values are Left, Right, AlternateStartLeft, and AlternateStartRight. Setting labels on the left places these on the outside of the scale while labels on the right places these on the inside of the scale. Alternate starts places the lowest range label respectively then every other label on alternating sides of the scale.
Scale Label Text Bold
Apply the bold style to the label text. Possible values are True or False.
Scale Label Text Color
Color of the label text. Possible colors are custom, web, and system colors.
Scale Label Text Size
Size of the label text. Possible values are literal values.
Scale Start Angle
Angle at which the circular scale starts in reference to the x-axis. For example, a start angle of 0° places the beginning of the scale on the positive x-axis. Possible values are 0 to 360.
Scale Sweep Angle
Span of the circular scale. For example, a sweep angle of 180° indicates a semicircular scale. Possible values are 0 to 360.
Scale Tick Major Frequency
Frequency of major ticks in reference to minor ticks on the scale. For example, on a scale that ranges from 1 to 100 with a Tick Unit value of 5, a major tick frequency setting of 5 sets a major division at every 5th minor division. The major division is each increment of 25. The major division is each increment of 25. Possible values are literal values.
Scale Tick Major Width
Width of the major tick marks to divide the scale. Possible values are literal values.
Scale Tick Width
Width of the minor tick marks to divide the scale. Possible values are literal values.
Tick Color
Color of the ticks that divide the scale. Possible colors are custom, web, and system colors.
Tick Unit
Value associated to individual tick divisions on the measuring scale. Possible values are literal values.
To insert a gauge
  • From the
    Toolbox
    , drag the gauge object into the workspace.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal