TcHmiCncButton

Komponente: TcHmiCncButton
Namespace: TcHmi.Controls.TcHmiCncBase
Verfügbar seit Version: 1.0.0

Beschreibung

Das Control TcHmiCncButton wird in der CNC-HMI als Standard-Interaktionsschaltfläche verwendet. Das Control ist ein allgemeiner Button, in welchem Sie ein Icon als SVG-Datei darstellen können. Optional können Sie ein Textlabel im Button angeben.

Inaktiv

Aktiv

Fehler

Gedrückt

Hovern

Rotiert

Horizontales Layout

TcHmiCncButton 1:

TcHmiCncButton 2:

TcHmiCncButton 3:

TcHmiCncButton 4:

TcHmiCncButton 5:

TcHmiCncButton 6:

TcHmiCncButton 7:

--CNC-HMI-Button-Background

--CNC-HMI-Button-Background-active

--CNC-HMI-Button-Background-error

--CNC-HMI-Button-Background-pressed

--CNC-HMI-Hover-Color

"Width Scale" = -1

"Height Scale" = -1

"Horizontal Layot" = true

Das Control TcHmiCncButton können Sie als Taster oder als Schalter nutzen. Für die vier Zustände „inaktiv", „aktiv", „Fehler" und „gedrückt" des Buttons können Sie über CSS-Variablen unterschiedliche Hintergrundfarben konfigurieren. Zusätzlich können Sie die Hintergrundfarbe definieren, die beim „Hovern“ über den Button genutzt wird. Sie können das im Button dargestellte Icon rotieren sowie einstellen, dass das Icon und das Textlabel horizontal zueinander angeordnet dargestellt werden.

Bedienung

Das Control TcHmiCncButton verfügt über keine spezielle Bedienung.

Konfiguration

Das Control TcHmiCncButton können Sie wie folgt konfigurieren. Dabei benötigen Sie kein spezielles Data Binding mit der TcHmiCnc-Extension.

TcHmiCncButton 8:

Nr.

Beschreibung

1

Den Pfad zum Icon als SVG-Datei können Sie hier definieren.

2

Wenn Sie "Width Scale" oder "Height Scale" auf "-1" setzen, wird das Icon um 180° rotiert.

3

Ein Textlabel im Button können Sie hier optional angeben.

4

False (Default): Der Button verhält sich als Taster.

True: Der Button verhält sich als Schalter.

5

True: Button ist im Initialzustand aktiv.

6

True: SVG-Datei als externe Ressource kennzeichnen.

7

True: Das Icon und das Textlabel werden horizontal zueinander angeordnet.

Benutzereinstellungen über TcHmiCncSettings

Das Control TcHmiCncButton verfügt über keine anpassbaren Einstellungen im Control TcHmiCncSettings.

Tastenkombination

Das Control TcHmiCncButton verfügt über keine spezifischen Tastenkombinationen.

API-Funktionen

Das Control TcHmiCncButton verfügt über ein öffentliches API, bei dem Sie folgende Funktionen nutzen können.

Funktion

Beschreibung

setText() /
getText()

Textlabel setzen bzw. lesen.

setIconPath() /
getIconPath()

Pfad zur SVG-Datei setzen bzw. lesen.

setIconWidthScale() /
getIconWidthScale()

Horizontalen Skalierungsfaktor setzen bzw. lesen.

setIconHeightScale() /
getIconHeightScale()

Vertikalen Skalierungsfaktor setzen bzw. lesen.

setToggleButton() /
getToggleButton()

Zwischen Button als Taster oder Schalter wechseln.

setToggled() /
getToggled()

Setzen bzw. lesen, ob der Button als Schalter im Initialzustand aktiv ist.

setExternalSVG() /
getExternalSVG()

SVG-Datei als externe Ressource kennzeichnen.

setHorizontalLayout() /
getHorizontalLayout()

Zwischen vertikalem und horizontalem Layout wechseln.

setActiveColor() /
getActiveColor()

Farbe des aktiven Zustands setzen bzw. lesen.

setInactiveColor() /
getInactiveColor()

Farbe des inaktiven Zustands setzen bzw. lesen.

setErrorColor() /
getErrorColor()

Farbe des Fehlerzustands setzen bzw. lesen.

Einfluss einer Benutzerverwaltung

Das Control TcHmiCncButton wertet das Zugriffsrecht „Operate" aus. Für „Allow" verhält sich das Control unverändert. Bei „Disallow" wird das Control auf Folgendes beschränkt: