GroupBox QML Type

Cadre visuel et titre pour un groupe logique de contrôles. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

GroupBox sert à regrouper un ensemble logique de contrôles au sein d'un cadre visuel titled. GroupBox ne fournit pas de mise en page propre, mais vous oblige à positionner son contenu, par exemple en créant un RowLayout ou un ColumnLayout.

Les éléments déclarés comme enfants d’un GroupBox sont automatiquement rattachés au contentItem du GroupBox. Les éléments créés dynamiquement doivent être explicitement rattachés au contentItem.

Si un seul élément est utilisé au sein d’une GroupBox, celle-ci s’adaptera à la taille implicite de l’élément qu’elle contient. Cela la rend particulièrement adaptée à une utilisation avec des mises en page.

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

GroupBox à cocher

Même si la GroupBox ne dispose pas de case à cocher intégrée, il est très simple de créer une GroupBox à cocher en l'associant à un CheckBox.

Une pratique courante consiste à activer ou désactiver les éléments enfants de la GroupBox lorsque sa case à cocher est cochée ou décochée, mais c’est à l’application de décider du comportement de la case à cocher.

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

Voir également « CheckBox» , « Personnalisation de la GroupBox » et « Contrôles conteneurs ».

Documentation sur les propriétés

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

Cette propriété contient la hauteur implicite de l'étiquette.

Sa valeur est égale à ` label ? label.implicitHeight : 0`.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitLabelWidth.

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

Cette propriété contient la largeur implicite de l'étiquette.

Sa valeur est égale à ` label ? label.implicitWidth : 0`.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également implicitLabelHeight.

label : Item

Cette propriété contient l'élément d'étiquette qui affiche la valeur « title ».

Voir également Personnalisation deGroupBox.

title : string

Cette propriété contient le titre.

Le titre s'affiche généralement au-dessus de la zone de groupe pour en résumer le contenu.