Linear gauge

BrowseName: LinearGauge
SuperType: Element (Item)
TypeView path: Tipi > UI > Controlli base > Indicatore lineare

Set and/or display a whole number value within a range of possible values.

How It Appears

../../../_images/ref_linearGauge_ex.gif

Applications

Typically used to set and/or display the value of an analog variable within a minimum and maximum value. Usually so-called warning zones are set to display specific ranges of values in different colors.

Properties

Name

BrowseName

DataType

Description

Value

Value

Float

Value displayed and possibly changed by the user

Minimum value

MinValue

Float

Minimum value displayed on the Y axis

Maximum value

MaxValue

Float

Maximum value displayed on the Y axis

Major tick count

MajorTickCount

Float

Quantity of main ranking signs

Minor tick count

MinorTickCount

Float

Quantity of secondary ranking signs

Label visible

LabelVisible

Boolean

Show/hide the scale values.

Editable

Editable

Boolean

Enable/disable the change of the value directly in the chart.

Scale padding

ScalePadding

Size

Value change behavior

ValueChangeBehaviour

ValueChangeBehaviour

Mode of updating text when the user writes in the text box. At end of typing = update the value after the user has pressed ENTER with either physical or virtual keyboard (pressing the ESC key or clicking outside the object, the previous text is restored); When typing = in real-time when writing.

Scale position

ScalePosition

PositionEnum

Position of the scale relative to the slider

Orientation

Orientation

OrientationEnum

Horizontal or vertical orientation of the object

Tooltip

Tooltip

Boolean

Show/hide the value above the selection point.

Warning zones

WarningZones

Collection of WarningZone

Ranges of values to display with a specific color.

Visible

Visible

Boolean

Show/hide the window.
(Inherited from Element)
Enabled

Enabled

Boolean

Enables/disables the interaction with the user (True = enabled; False = disabled).
(Inherited from Element)
Opacity

Opacity

Float

Opacity level (0 = transparent)
(Inherited from Element)
Left margin

LeftMargin

Size

(Only if Horizontal Alignment = Left or Center or Stretch) Distance between the left edge of the object and the left edge of its container.
(Inherited from Element)
Top margin

TopMargin

Size

(Only if Vertical Alignment = Top or Center or Stretch) Distance between the top edge of the object and the top edge of its container.
(Inherited from Element)
Right margin

RightMargin

Size

(Only if Horizontal Alignment = Right or Center or Stretch) Distance between the right edge of the object and the right edge of its container.
(Inherited from Element)
Bottom margin

BottomMargin

Size

(Only if Vertical Alignment = Bottom or Center or Stretch) Distance between the bottom edge of the object and the bottom edge of its container.
(Inherited from Element)
Width

Width

Size

Width of the window. It can assume values greater than or equal to zero. The Auto value sets the width equal to the width of the content (in this case, in the absence of content the object collapses).
(Inherited from Element)
Height

Height

Size

Height of the window. It can assume values greater than or equal to zero. The Auto value sets the height equal to the height of the content (in this case, in the absence of content the object collapses).
(Inherited from Element)
Horizontal alignment

HorizontalAlignment

HorizontalAlignment

Alignment of the object on the horizontal axis. Left = the left side is positioned on the left side of the container, except for the left margin; Right = the right side is positioned on the right side of the container, except for the right margin; Center = the center of the object is positioned in the center of the container, except for the left and/or right margins; Stretch = object width equals container width, except for the left and/or right margins.
(Inherited from Element)
Vertical alignment

VerticalAlignment

VerticalAlignment

Alignment of the object on the vertical axis. Top = the top side is positioned on the top side of the container, except for the top margin; Bottom = the bottom side is positioned on the bottom side of the container, except for the bottom margin; Center = the center of the object is positioned in the center of the container, except for the top and/or bottom margins; Stretch = object height equals container height, except for the top and/or bottom margins.
(Inherited from Element)
Rotation

Rotation

Size

Rotation of the object around its center point. Positive values indicate clockwise arc degrees.
(Inherited from Element)

Events

Modified value

BrowseName: UserValueChanged