Linear Gauge

Eine Linear Gauge ist eine Linearanzeige, in der ein Wert über das Ausfüllen eines Balkens angezeigt werden kann. Für diesen Balken kann ein Start- und ein Endwert festgelegt werden. Über das Attribut ‚Editable‘ kann ein Slider eingeblendet werden, durch den der Bediener den verknüpften Wert verändern kann.

Attribute

Kategorie: Colors

Name

Beschreibung

ProgressBackgroundColor

Definition der Hintergrundfarbe des Balkens

ProgressForegroundColor

Definition der Balkenfarbe

ValueColor

Definition der Textfarbe der Anzeige des aktuellen Wertes

UnitColor

Definition der Farbe der Einheit

TickColor

Definition der Farbe der Balkenunterteilung

LabelColor

Definition der Textfarbe der Skalierungswerte

Knob Color

Definition der Füllfarbe des Sliders

KnobArrowsColor

Definition der Umriss- und Pfeilfarbe des Sliders

BackgroundColor

Definition der Hintergrundfarbe

BorderColor

Definition der Rahmenfarbe des Controls

Kategorie: Layout

Name

Beschreibung

Orientation

Auswahl der Orientierung:

  • Horizontal: Die Linearanzeige mit der Skalierung ist horizontal ausgerichtet.
  • Vertical: Die Linearanzeige mit der Skalierung ist vertikal ausgerichtet.

Padding

Definition eines zusätzlichen Abstands zwischen Rahmen des Controls und dem Balken für die vier Seiten

Left

Definition des Abstands der linken Seite zur linken Seite des umschließenden Controls

LeftUnit

Definition der Einheit des Abstands zur rechten Seite des umschließenden Controls:

  • Pixel für eine absolute Positionierung
  • Prozent für eine relative Positionierung

Top

Definition des Abstands der oberen Seite zur oberen Seite des umschließenden Controls

TopUnit

Auswahl der Einheit des Abstands zur oberen Seite des umschließenden Controls:

  • Pixel für eine absolute Positionierung
  • Prozent für eine relative Positionierung

Right

Definition des Abstands der rechten Seite zur rechten Seite des umschließenden Controls

RightUnit

Auswahl der Einheit des Abstands zur rechten Seite des umschließenden Controls:

  • Pixel für eine absolute Positionierung
  • Prozent für eine relative Positionierung

Bottom

Definition des Abstands der unteren Seite zur unteren Seite des umschließenden Controls

BottomUnit

Auswahl der Einheit des Abstands zur unteren Seite des umschließenden Controls:

  • Pixel für eine absolute Positionierung
  • Prozent für eine relative Positionierung

Width

Definition der äußeren Breite des Controls

WidthUnit

Auswahl der Einheit der Breite:

  • Pixel für eine absolute Breite
  • Prozent für eine relative Breite

Height

Definition der äußere Höhe des Controls

HeightUnit

Auswahl der Einheit der Höhe:

  • Pixel für eine absolute Höhe
  • Prozent für eine relative Höhe

MaxWidth

Definition der maximalen Breite, wenn die Control-Größe dynamisch definiert ist.

MaxWidthUnit

Auswahl der Einheit der maximalen Breite:

  • Pixel für einen absoluten Wert
  • Prozent für einen relativen Wert

MinWidth

Definition der minimalen Breite, wenn die Control-Größe dynamisch definiert ist.

MinWidthUnit

Auswahl der Einheit der minimalen Breite:

  • Pixel für einen absoluten Wert
  • Prozent für einen relativen Wert

MaxHeight

Definition der maximalen Höhe, wenn die Control-Größe dynamisch definiert ist.

MaxHeightUnit

Auswahl der Einheit der maximalen Höhe:

  • Pixel für einen absoluten Wert
  • Prozent für einen relativen Wert

MinHeight

Definition der minimalen Höhe, wenn die Control-Größe dynamisch definiert ist.

MinHeightUnit

Auswahl der Einheit der minimalen Höhe:

  • Pixel für einen absoluten Wert
  • Prozent für einen relativen Wert

RenderedLeft

Berechneter Pixel-Abstand der linken Seite zur linken Seite des umschließenden Controls

RenderedTop

Berechneter Pixel-Abstand der oberen Seite zur oberen Seite des umschließenden Controls

RenderedRight

Berechneter Pixel-Abstand der rechten Seite zur rechten Seite des umschließenden Controls

RenderedBottom

Berechneter Pixel-Abstand der unteren Seite zur unteren Seite des umschließenden Controls

RenderedWidth

Berechnete Pixel-Breite des Controls

RenderedHeight

Berechnete Pixel-Höhe des Controls

GridRowIndex

Definition der Zeile eines Grids, in der das Control dargestellt werden soll.

GridColumnIndex

Definition der Spalte eines Grids, in der das Control dargestellt werden soll.

Opacity

Definition der Transparenz des ganzen Controls

Visibility

Auswahl der Sichtbarkeit eines Controls:

  • Visible: Control ist sichtbar.
  • Hidden: Control ist unsichtbar, wird aber gezeichnet – Controls dahinter sind nicht bedienbar.
  • Collapsed: Control ist unsichtbar und wird nicht gezeichnet – Controls dahinter sind bedienbar.

ZIndex

Definition der Position auf der Z-Achse

Transform

Definition einer Transformation eines Controls:

  • Translate: Verschieben in X-, Y-, Z-Richtung
  • Rotate: Drehen um einen Winkel
  • Scale: Zoomen um einen Faktor
  • Skew: Schräges Darstellen der Seiten um einen Winkel
  • Origin: Setzen des Ursprungs der Transformation relativ zur Position des Controls
  • Perspective: Setzen der Perspektive der Transformationen aller Kindelemente

BoxShadow

Definition eines Schattens

WidthMode

Auswahl der Methode zur Berechnung der Breite :

  • Value: Die Breite wird durch die eingetragene Breite definiert.
  • Parent: Die Breite wird durch den Abstand zur linken und rechten Seite des Elternelements definiert. Das Attribut ‚Width‘ wird in allen Berechnungen ignoriert!

HeightMode

Auswahl der Methode zur Berechnung der Höhe:

  • Value: Die Höhe wird durch die eingetragene Höhe definiert.
  • Parent: Die Höhe wird durch den Abstand zur oberen und unteren Seite des Elternelements definiert. Das Attribut ‚Height‘ wird in allen Berechnungen ignoriert!

Kategorie: Common

Name

Beschreibung

Value

Definition des Wertes, der dargestellt werden soll

Editable

Auswahl, ob der Slider dargestellt werden soll und damit die Linear Gauge editierbar ist

BaseAnimationTime

Definition der Basisanimationszeit in Millisekunden – Sie beschreibt die Zeit der Animation von Minimal- zu Maximalwert.

IsEnabled

Auswahl, ob ein Control aktiviert sein soll

Id

Definition des Namens des Control

Type

Typname des Controls

ClassNames

Definition von Control Klassen

IsAttached

Es ist ein Control logisch im DOM eingehangen.

Tooltip

Definition des Tooltips für das Control

Kategorie: Border

Name

Beschreibung

BorderRadius

Definition des Radius der vier Ecken, um diese abzurunden

BorderStyle

Auswahl des Rahmenstils der vier Seiten des Controls

BorderWidth

Definition der Rahmenbreite der vier Seiten des Controls

Kategorie: Background Image

Name

Beschreibung

BackgroundImage

Definition eines Bildes, welches oberhalb der Hintergrundfarbe liegt

BackgroundImageHeight

Definition der Höhe des Hintergrundbildes

BackgroundImageHeightUnit

Auswahl der Einheit der Höhe des Hintergrundbildes:

  • Pixel für eine absolute Höhe
  • Prozent für eine relative Höhe

BackgroundImageWidth

Definition der Breite des Hintergrundbildes

BackgroundImageWidthUnit

Auswahl der Einheit der Breite des Hintergrundbildes:

  • Pixel für eine absolute Breite
  • Prozent für eine relative Breite

BackgroundImagePadding

Definition eines zusätzlichen Abstands zwischen dem Rahmen des Controls und dem Hintergrundbild für die vier Seiten

BackgroundImageVerticalAlignment

Definition der vertikalen Ausrichtung des Hintergrundbildes innerhalb des Controls

BackgroundImageHorizontalAlignment

Definition der horizontalen Ausrichtung des Hintergrundbildes innerhalb des Controls

Kategorie: Value

Name

Beschreibung

MinValue

Definition des kleinsten Wertes, den das Control grafisch darstellen soll

MaxValue

Definition des größten Wertes, den das Control grafisch darstellen soll

Step

Definition der Schrittweite bei der Änderung des Wertes über den Slider

ShowValueText

Auswahl, ob der aktuelle Wert angezeigt werden soll

Range

Definition des Wertebereichs der Farbskalen

StartFromZero

Auswahl, ob der Minimalwert unabhängig von dem Attribut ‚Minimal Value‘ Null sein soll – Diese Einstellung hat keinen Effekt, wenn der eingestellte Minimalwert gleich oder größer als Null ist.

ValueFontFamily

Definition der Schriftart über den Namen der Schriftfamilie oder das Schlüsselwort

ValueFontSize

Definition der Schriftgröße

ValueFontSizeUnit

Auswahl der Einheit der Schriftgröße:

  • Pixel für eine absolute Größe
  • Prozent für eine relative Größe

ValueFontStyle

Auswahl der Schriftlage:

  • Normal
  • Italic: kursiv
  • Oblique: schräggestellt

ValueFontWeight

Auswahl der Schriftstärke:

  • Normal
  • Bold: fett

ValueFormat

Definition von einer Formatierungsfunktion für den Wert

ClickAnywheretoEdit

Auswahl, ob durch das Klicken an einer beliebigen Stelle im Control der Wert geändert werden kann

Kategorie: Labels

Name

Beschreibung

ShowLabels

Auswahl, ob die Skalierungswerte angezeigt werden sollen

Label Range

Definition der Sprungweite zwischen den einzelnen Skalierungswerten

Label Position

Auswahl der Position der Skalierung zum Balken:

Für eine horizontale Ausrichtung stehen die folgenden Möglichkeit zur Auswahl:

  • Top
  • Bottom

Für eine vertikale Ausrichtung stehen die folgenden Möglichkeiten zur Auswahl:

  • Left
  • Right

LabelFontFamily

Definition der Schriftart über den Namen der Schriftfamilie oder das Schlüsselwort

LabelFontSize

Definition der Schriftgröße der Skalierung

LabelFontSizeUnit

Auswahl der Einheit der Schriftgröße:

  • Pixel für eine absolute Größe
  • Prozent für eine relative Größe

LabelFontStyle

Auswahl der Schriftlage der Skalierung:

  • Normal
  • Italic: kursiv
  • Oblique: schräggestellt

LabelFontWeight

Auswahl der Schriftstärke der Skalierung:

  • Normal
  • Bold: fett

LabelFormat

Definition einer Formatierungsfunktion für die Skalierung

Kategorie: Ticks

Name

Beschreibung

ShowTicks

Auswahl, ob die Skalierungsunterteilung angezeigt werden soll

TickDefinition

Definition der Skaleneinteilung

Kategorie: Unit

Name

Beschreibung

Unit

Definition der Einheit oder der Beschreibung des Wertes

UnitOrientation

Auswahl der Orientierung der Einheit:

  • Theme
  • Horizontal
  • Vertikal

UnitFontSize

Definition der Schriftgröße der Einheit

UnitFontSizeUnit

Auswahl der Einheit der Schriftgröße:

  • Pixel für eine absolute Größe
  • Prozent für eine relative Größe

UnitFontStyle

Auswahl der Schriftlage der Einheit:

  • Normal
  • Italic: kursiv
  • Oblique: schräggestellt

UnitFontWeight

Auswahl der Schriftstärke der Einheit:

  • Normal
  • Bold: fett

Ereignisse

Kategorie: Control

Name

Beschreibung

onValueChanged

Der Wert wurde verändert.

Kategorie: Framework

Name

Beschreibung

onAttached

Das Control wurde zur Anzeige hinzugefügt.

onDetached

Das Control wurde aus der Anzeige genommen.

onInitialized

Das Control wurde initialisiert.

onDestroyed

Das Control wurde zerstört.

onMoved

Das Control wurde bezogen auf das Browserfenster bewegt.

onResized

Das Control wurde in seiner Größe verändert.

Kategorie: Operator

Name

Beschreibung

onUserInteractionFinished

Der Benutzer hat die Interaktion mit dem Control beendet.

onPressed

Es wurde per Maus geklickt oder ein Touchbildschirm kurz berührt.

onMouseClick

Die linke Maustaste wurde über dem Control gedrückt und losgelassen.

onMouseDoubleClick

Die linke Maustaste wurde zweimal über dem Control gedrückt und losgelassen.

onMouseRightClick

Die rechte Maustaste wurde über dem Control gedrückt und losgelassen.

onMouseDown

Eine Maustaste wurde über dem Control heruntergedrückt.

onMouseEnter

Der Mauszeiger wurde über das Control bewegt.

onMouseLeave

Der Mauszeiger hat das Control verlassen.

onMouseUp

Eine Maustaste wurde über dem Control losgelassen.

onMouseDownLeft

Die linke Maustaste wurde über dem Control heruntergedrückt.

onMouseDownRight

Die rechte Maustaste wurde über dem Control heruntergedrückt.

onMouseMove

Die Maus wurde über dem Control bewegt.

onMouseOver

Der Mauszeiger wurde über das Control oder eines seiner Kinder bewegt.

onMouseOut

Der Mauszeiger hat das Control oder eines seiner Kind-Controls verlassen.

onMouseUpLeft

Die linke Maustaste wurde über dem Control losgelassen.

onMouseUpRight

Die rechte Maustaste wurde über dem Control losgelassen.

onMouseWheel

Das Mausrad wurde über dem Control bewegt.

onTouchStart

Ein Finger/Stift wurde auf ein Touchbildschirm abgesetzt.

onTouchMove

Ein Finger/Stift wurde auf einem Touchbildschirm bewegt.

onTouchEnd

Ein Finger/Stift wurde von einem Touchbildschirm genommen.

onTouchCancel

Eine Interaktion mit einem Touchbildschirm wurde abgebrochen.

Zugriffsrechte

Name

Beschreibung

observe

Legt fest, ob das Control allgemein beobachtbar ist.

operate

Legt fest, ob das Control allgemein bedienbar ist.

Vererbungshierarchie

Control

    Linear Gauge

NuGet-Paket: Beckhoff.TwinCAT.HMI.Controls

Linear Gauge 1:

NuGet-Pakete sind verfügbar ab Version 1.12.

Linear Gauge 2:

Verfügbar ab Version 1.8

Siehe auch

API-Referenz dieses Controls