CheckBox QML Type

Kontrollkästchen, das ein- und ausgeschaltet werden kann. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• checkState : enumeration
• nextCheckState : function (since QtQuick.Controls 2.4 (Qt 5.11))
• tristate : bool

Ausführliche Beschreibung

CheckBox stellt ein Optionsfeld dar, das aktiviert (markiert) oder deaktiviert (nicht markiert) werden kann. Kontrollkästchen werden in der Regel verwendet, um eine oder mehrere Optionen aus einer Reihe von Optionen auszuwählen. Bei größeren Optionsmengen, wie beispielsweise in einer Liste, sollten Sie stattdessen die Verwendung von „ CheckDelegate “ in Betracht ziehen.

„CheckBox“ erbt seine API von „ AbstractButton “. So lässt sich beispielsweise der Status des Kontrollkästchens über die Eigenschaft „ checked “ festlegen.

Neben den Zuständen „aktiviert“ und „deaktiviert“ gibt es einen dritten Zustand: „teilweise aktiviert“. Der Zustand „teilweise aktiviert“ kann mithilfe der Eigenschaft „ tristate “ aktiviert werden. Dieser Zustand zeigt an, dass der reguläre Zustand „aktiviert“ oder „deaktiviert“ nicht bestimmt werden kann; in der Regel aufgrund anderer Zustände, die das Kontrollkästchen beeinflussen. Dieser Zustand ist beispielsweise nützlich, wenn in einer Baumansicht mehrere untergeordnete Knoten ausgewählt sind.

ColumnLayout {
    CheckBox {
        checked: true
        text: qsTr("First")
    }
    CheckBox {
        text: qsTr("Second")
    }
    CheckBox {
        checked: true
        text: qsTr("Third")
    }
}

Hierarchische Kontrollkästchengruppen können mit einem nicht-exklusiven ` ButtonGroup` verwaltet werden.

Das folgende Beispiel veranschaulicht, wie der kombinierte Markierungsstatus der untergeordneten Elemente an den Markierungsstatus des übergeordneten Kontrollkästchens gebunden werden kann:

Column {
    ButtonGroup {
        id: childGroup
        exclusive: false
        checkState: parentBox.checkState
    }

    CheckBox {
        id: parentBox
        text: qsTr("Parent")
        checkState: childGroup.checkState
    }

    CheckBox {
        checked: true
        text: qsTr("Child 1")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }

    CheckBox {
        text: qsTr("Child 2")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }
}

Siehe auch „Anpassen von CheckBox-, ButtonGroup- und Button-Steuerelementen“.

Eigenschaftsdokumentation

checkState : enumeration

Diese Eigenschaft speichert den Status des Kontrollkästchens.

Verfügbare Zustände:

Siehe auch „ tristate “ und „ checked “.

nextCheckState : function [since QtQuick.Controls 2.4 (Qt 5.11)]

Diese Eigenschaft enthält eine Callback-Funktion, die aufgerufen wird, um den nächsten Status des Kontrollkästchens zu bestimmen, sobald der Benutzer das Kontrollkästchen interaktiv per Touch, Maus oder Tastatur umschaltet.

Standardmäßig wechselt ein normales Kontrollkästchen zwischen den Zuständen „ Qt.Unchecked “ und „ Qt.Checked “, während ein Kontrollkästchen mit drei Zuständen zwischen den Zuständen „ Qt.Unchecked “, „ Qt.PartiallyChecked “ und „ Qt.Checked “ wechselt.

Die Callback-Funktion „ nextCheckState “ kann das Standardverhalten überschreiben. Das folgende Beispiel implementiert ein Checkbox-Element mit drei Zuständen, das je nach externen Bedingungen einen teilweise markierten Zustand anzeigen kann, jedoch niemals in den teilweise markierten Zustand wechselt, wenn es vom Benutzer interaktiv umgeschaltet wird.

CheckBox {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.

tristate : bool

Diese Eigenschaft gibt an, ob es sich bei dem Kontrollkästchen um ein Tri-State-Kontrollkästchen handelt.

In der folgenden Animation ist das erste Kontrollkästchen ein Tri-State-Kontrollkästchen:

Die Standardeinstellung ist „ false “, d. h., das Kontrollkästchen hat nur zwei Zustände.