CheckDelegate QML Type

Element-Delegat mit einem Kontrollkästchen, das aktiviert oder deaktiviert werden kann. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

CheckDelegate stellt einen Element-Delegaten bereit, der aktiviert (markiert) oder deaktiviert (unmarkiert) werden kann. Check-Delegaten werden typischerweise verwendet, um eine oder mehrere Optionen aus einer Reihe von Optionen in einer Liste auszuwählen. Bei kleineren Optionsmengen oder bei Optionen, die eindeutig identifizierbar sein müssen, sollten Sie stattdessen die Verwendung von „ CheckBox “ in Betracht ziehen.

„CheckDelegate“ erbt seine API von „ ItemDelegate “, das wiederum von „ AbstractButton “ abgeleitet ist. So können Sie beispielsweise „ text “ festlegen und mithilfe der „ AbstractButton “-API auf „ clicks “ reagieren. Der Status des Check-Delegates lässt sich über die Eigenschaft „ checked “ festlegen.

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

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

Siehe auch „Anpassen von CheckDelegate“, „Delegat-Steuerelemente“ und „ CheckBox “.

Eigenschaftsdokumentation

checkState : enumeration

Diese Eigenschaft legt den Prüfstatus des Prüfdelegaten fest.

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 Check-Zustand zu bestimmen, sobald der Check-Delegat vom Benutzer interaktiv per Touch, Maus oder Tastatur umgeschaltet wird.

Standardmäßig wechselt ein normaler Check-Delegat zwischen den Zuständen „ Qt.Unchecked “ und „ Qt.Checked “, während ein Tri-State-Check-Delegat zwischen den Zuständen „ Qt.Unchecked “, „ Qt.PartiallyChecked “ und „ Qt.Checked “ wechselt.

Die Callback-Funktion „ nextCheckState “ kann das Standardverhalten überschreiben. Das folgende Beispiel implementiert einen Tri-State-Check-Delegaten, der je nach externen Bedingungen einen teilweise markierten Zustand anzeigen kann, jedoch niemals in den teilweise markierten Zustand wechselt, wenn er vom Benutzer interaktiv umgeschaltet wird.

CheckDelegate {
    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 legt fest, ob der Check-Delegat drei Zustände hat.

In der folgenden Animation verfügt der erste CheckDelegate über drei Zustände:

Die Standardeinstellung ist „ false “, d. h., der Delegate hat nur zwei Zustände.