Checkbox

Check-Boxen sind dazu da, um eine Auswahl aus mehreren vorgegebenen Alternativen zu erlauben. Damit können etwa Datenpunktwerte gesetzt oder Aktionen ausgelöst werden. Beispielsweise die Zuschaltung der ersten und dritten von drei installierten Pumpen.

Checkboxen sind Listen mit kleinen, viereckigen Schaltflächen am linken Rand der Einträge (Optionen), von denen mehrere zur gleichen Zeit gedrückt (angehakt) sein können. Checkboxen unterscheiden sich im Aussehen von Radioboxen dadurch, dass die Schaltflächen am linken Rand Quadrate sind.

Abbildung 1. Checkbox

So erstellen Sie eine Checkbox

  1. Klicken Sie auf das Werkzeug für Checkbox .
  2. Klicken Sie in die Panelarbeitsfläche und Bestimmen Sie die Größe mit Drag&Drop.
  3. Öffnen Sie das Eigenschaftenfenster.
  4. Ändern Sie den Objektnamen neben (Name).
  5. Tragen Sie die Optionen im Checkbox-Editor ein, den Sie durch Klick auf die ...-Schaltfläche öffnen.

Checkbox-Editor

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

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

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.

Abbildung 2. Checkbox-Editor

Checkbox Clicked Besispielskript

Abhängig von Position oder Status der Checkbox können die Aktionen ausgelöst werden. Daher werden die Parameter "button" und "state" in der main()-Funktion übergeben. Im folgenden Skript wird der Wert eines Datenpunktes, abhängig von der Position aus 33 oder 66 gesetzt und zur Kontrolle abgefragt und ausgegeben. Ähnlich können Sie z.B. den Stellgrad eines Ventils mit einer Checkbox als Sollwert vorgeben.

//Function Checkbox1 Clicked()
main(int button, bool
state)
{
  float x;
  string dp;
  DebugN(button);
  if ( button == 0 )
  {
    dpSet("System1:ExampleDP_Arg1.:_original.._value", 33);
    dpGet("System1:ExampleDP_Arg1.:_original.._value", x);
    DebugN("check box 1" + "State: " + state + "Online value " + x);
  }
  if ( button == 1 )
  {
    dpSet("System1:ExampleDP_Arg1.:_original.._value", 66);
    dpGet("System1:ExampleDP_Arg1.:_original.._value", x);
    DebugN("check box 2" + "State: " + state + "Online value " + x);
  }
}

Nützliche Hinweise

Im Eigenschaftenfenster können Sie ein Hotkey zur Tastaturbedienung zuweisen. Die Schriftformatierung können Sie auch im Eigenschaftenfenster (Font) bestimmen.

Eine Checkbox kann über die Eigenschaft vertikal des Eigenschaftenfensters horizontal (FALSE) oder vertikal (TRUE) angezeigt werden.

Auf der Registerkarte Standard bestimmen Sie die Attribute der Checkbox wie die Farbe, siehe auch weitere Checkbox-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).

QCheckBox::indicator 
{
  width: 1em; 
  height: 1em; 
  image: url(pictures:/PopupMenu/checkbox_unchecked.svg);
} 

QCheckBox::indicator:checked 
{
  image: url(pictures:/PopupMenu/checkbox_checked.svg);
}