GroupBox QML Type

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

• Liste aller Elemente, einschließlich geerbter Elemente

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

Ausführliche Beschreibung

GroupBox wird verwendet, um eine logische Gruppe von Steuerelementen innerhalb eines visuellen Rahmens namens „ titled “ gemeinsam anzuordnen. GroupBox bietet kein eigenes Layout, sondern erfordert, dass Sie den Inhalt positionieren, beispielsweise durch das Erstellen eines „ RowLayout “ oder eines „ ColumnLayout “.

Elemente, die als untergeordnete Elemente einer GroupBox deklariert werden, werden automatisch dem „ contentItem “ der GroupBox zugeordnet. Dynamisch erstellte Elemente müssen explizit dem „contentItem“ zugeordnet werden.

Wird innerhalb einer GroupBox nur ein einziges Element verwendet, passt sich ihre Größe automatisch an die implizite Größe des enthaltenen Elements an. Dadurch eignet sie sich besonders gut 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") }
    }
}

Ankreuzbare GroupBox

Obwohl die GroupBox über kein integriertes Kontrollkästchen verfügt, lässt sich auf einfache Weise eine GroupBox mit Kontrollkästchen erstellen, indem man sie mit einem „ CheckBox “ kombiniert.

Es ist ein gängiges Muster, die untergeordneten Elemente der GroupBox zu aktivieren oder zu deaktivieren, wenn ihr Kontrollkästchen ein- oder ausgeschaltet wird; die Entscheidung über das Verhalten des Kontrollkästchens liegt jedoch bei der Anwendung.

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“ , „Anpassen der GroupBox“ und „Container-Steuerelemente“.

Dokumentation zu den Eigenschaften

implicitLabelHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Beschriftungshöhe.

Der Wert entspricht „ label ? label.implicitHeight : 0 “.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch „ implicitLabelWidth “.

implicitLabelWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Beschriftungsbreite.

Der Wert entspricht „ label ? label.implicitWidth : 0 “.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch „ implicitLabelHeight “.

label : Item

Diese Eigenschaft enthält das Beschriftungselement, das „ title “ anzeigt.

Siehe auch „Anpassen von GroupBox“.

title : string

Diese Eigenschaft enthält den Titel.

Der Titel wird in der Regel oberhalb des Gruppenfelds angezeigt, um dessen Inhalt zusammenzufassen.