CheckDelegate QML Type

Objektdelegat mit einem Prüfzeichen, das ein- oder ausgeschaltet 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

Detaillierte Beschreibung

CheckDelegate stellt einen Elementdelegaten dar, der ein- (angekreuzt) oder ausgeschaltet (nicht angekreuzt) werden kann. CheckDelegates werden normalerweise verwendet, um eine oder mehrere Optionen aus einer Reihe von Optionen in einer Liste auszuwählen. Für kleinere Sätze von Optionen oder für Optionen, die eindeutig identifizierbar sein müssen, sollten Sie stattdessen CheckBox verwenden.

CheckDelegate erbt seine API von ItemDelegate, die von AbstractButton geerbt wird. Sie können zum Beispiel text setzen und auf clicks reagieren, indem Sie die API AbstractButton verwenden. Der Zustand des CheckDelegates kann mit der Eigenschaft checked festgelegt werden.

Zusätzlich zu den Zuständen "checked" und "unchecked" gibt es einen dritten Zustand: "partially checked". Der Status "teilweise geprüft" kann mit der Eigenschaft tristate aktiviert werden. Dieser Zustand zeigt an, dass der reguläre Status "checked/unchecked" nicht bestimmt werden kann; im Allgemeinen aufgrund anderer Zustände, die den Prüfdelegaten beeinflussen. Dieser Zustand ist z. B. nützlich, wenn mehrere untergeordnete Knoten in einer Baumansicht ausgewählt sind.

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

Siehe auch CheckDelegate anpassen, Delegate Controls und CheckBox.

Eigenschaft Dokumentation

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
    }
}

tristate : bool

Diese Eigenschaft bestimmt, ob der Prüfdelegat drei Zustände hat.

In der Animation unten ist das erste Checkdelegat dreistufig:

Die Voreinstellung ist false, d.h. der Delegat hat nur zwei Zustände.