GroupBox QML Type

Visueller Rahmen und Titel für eine logische Gruppe von Steuerelementen. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• implicitLabelHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitLabelWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• label : Item
• title : string

Detaillierte Beschreibung

GroupBox wird verwendet, um eine logische Gruppe von Steuerelementen innerhalb eines visuellen Rahmens titled zusammen anzuordnen. Die GroupBox bietet kein eigenes Layout, sondern erfordert, dass Sie ihren Inhalt positionieren, z. B. durch Erstellen einer RowLayout oder einer ColumnLayout.

Elemente, die als Kinder einer GroupBox deklariert sind, werden automatisch der contentItem der GroupBox untergeordnet. Dynamisch erstellte Elemente müssen explizit mit dem contentItem verknüpft werden.

Wenn nur ein einzelnes Element in einer GroupBox verwendet wird, passt es seine Größe an die implizite Größe des enthaltenen Elements an. Dies macht sie besonders geeignet für die Verwendung in Verbindung mit Layouts.

GroupBox {
    title: qsTr("Synchronize")
    ColumnLayout {
        anchors.fill: parent
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

Überprüfbare GroupBox

Auch wenn die GroupBox kein eingebautes Kontrollkästchen hat, ist es einfach, eine überprüfbare GroupBox zu erstellen, indem man sie mit einer CheckBox verbindet.

Es ist ein gängiges Muster, die Kinder der GroupBox zu aktivieren oder zu deaktivieren, wenn das Kontrollkästchen ein- oder ausgeschaltet wird, aber es liegt an der Anwendung, das Verhalten des Kontrollkästchens zu bestimmen.

GroupBox {
    label: CheckBox {
        id: checkBox
        checked: true
        text: qsTr("Synchronize")
    }

    ColumnLayout {
        anchors.fill: parent
        enabled: checkBox.checked
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

Siehe auch CheckBox, GroupBox anpassen und Container Controls.

Eigenschaft Dokumentation