Radiobox

Radioboxen sind dazu da, um die Auswahl genau einer Option aus mehreren vorgegebenen Alternativen zu erlauben. Damit können etwa Datenpunktwerte gesetzt oder Aktionen ausgelöst werden. Ein Beispiel wäre z.B. die Umschaltung zwischen Automatik, Handbetrieb und dem Zustand "Aus".

Radioboxen werden als Listen mit kleinen, kreisförmigen Schaltflächen am linken Rand der Einträge (entweder/oder-Optionen) dargestellt, von denen immer nur eine gedrückt sein kann.

Abbildung 1. Radiobox

So erstellen Sie eine Radiobox

  1. Klicken Sie auf das Werkzeug für Radiobox .
  2. Klicken Sie in die Panelarbeitsfläche. Bestimmen Sie die Größe.
  3. Öffnen Sie das Eigenschaftenfenster.
  4. Vergeben Sie einen Namen im Feld neben (Name).
  5. Tragen Sie die Optionen im Radiobox-Editor ein, den Sie durch Klick auf die ...-Schaltfläche öffnen.

Radiobox-Editor

Der Radiobox-Editor dient zur Verwaltung der einzelnen Einträge.

Mit einem Doppelklick auf die Radiobox im Panel oder einfachem Click auf die ...-Schaltfläche der Editor-Eigenschaft während des Engineerings, kann der Radiobox-Editor geöffnet werden.

Abbildung 2. Radiobox Editor

Durch Anklicken der Schaltfläche Danach Einfügen wird der neue Eintrag hinter die im Einträge-Feld markierte Option gesetzt. Durch Anklicken der Schaltfläche Davor Einfügen wird der neue Eintrag vor die im Einträge-Feld markierte Option gesetzt. Durch Anklicken der Schaltfläche Umbenennen kann die Option umbenannt werden. Durch Anklicken der Schaltfläche Entfernen wird die markierte Option gelöscht.

Radiobox Beispielskript für Umschaltung

Ein Skript für eine Radiobox mit vier Optionen, die den Schaltzustand eines Ventils (geschlossen, schließt, öffnet, offen) ausgibt, würde beispielsweise folgendermaßen lauten. Die Funktion dpConnect() ruft bei jeder Änderung des Onlinewertes der Datenpunktvariablen "VD01.EinAus" die Funktion switching() auf. Diese setzt die Radiobox-Optionen je nach dem übermittelten Onlinewert. Vorausgesetzt wird, dass den Schaltzuständen die Onlinewerte 0, 1, 2 und 3 zugeordnet sind.

main()
{
  dpConnect("switching", "VD01.OnOff:_online.._value");
}

switching(string dp, int s)
{
  setValue("", "number", s);
}

Nützliche Hinweise

Die Schriftformatierung der Einträge kann im Eigenschaftenfenster geändert werden.

Eine Radiobox kann entweder vertikal oder horizontal angezeigt werden, indem die Eigenschaft vertical im Eigenschaftenfenster festgelegt wird.

Zugehörige Funktionen finden Sie im Kapitel Radiobox-Funktionen.

Styling der Indikatoren

Auf Windows-Systemen werden die Indikatoren nicht skaliert, wenn der native Stil verwendet wird (d. h. wenn für die Benutzeroberfläche keine Einstellung -style angegeben ist), da sie vom Betriebssystem und nicht vom Qt-Styling-System stammen. Falls diese gestaltet werden müssen, wird empfohlen, entweder die Benutzeroberfläche mit dem Parameter -style fusion zu starten oder benutzerdefinierte Symbole mit einem Stylesheet anzugeben (siehe nachfolgendes Beispiel).

QRadioButton::indicator 
{
  width: 1em; 
  height: 1em; 
  image: url(pictures:/radio_off.svg);
} 

QRadioButton::indicator:checked 
{
  image: url(pictures:/radio_on.svg);
}