GroupBox QML Type

Cadre visuel et titre pour un groupe logique de contrôles. Plus d'informations...

• 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 est utilisé pour présenter un groupe logique de contrôles à l'intérieur d'un cadre visuel titled. GroupBox ne fournit pas de mise en page propre, mais nécessite que vous positionniez son contenu, par exemple en créant un RowLayout ou un ColumnLayout.

Les éléments déclarés comme enfants d'une GroupBox sont automatiquement rattachés à l'élément contentItem de la GroupBox. Les éléments créés dynamiquement doivent être explicitement rattachés à l'élément de contenu.

Si un seul élément est utilisé dans une GroupBox, il sera redimensionné pour s'adapter à la taille implicite de l'élément qu'il contient. C'est pourquoi elle est particulièrement adaptée aux 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 contrôlable

Bien que la GroupBox ne possède pas de case à cocher intégrée, il est facile de créer une GroupBox à cocher en l'associant à une page CheckBox.

Il est courant d'activer ou de désactiver les enfants de la GroupBox lorsque la case à cocher est activée ou désactivé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, Personnaliser la boîte de groupe et Contrôles de conteneur.

Documentation sur les propriétés

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

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

La valeur est égale à label ? label.implicitHeight : 0.

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

Voir aussi implicitLabelWidth.

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

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

La valeur est égale à label ? label.implicitWidth : 0.

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

Voir aussi implicitLabelHeight.

label : Item

Cette propriété contient l'élément d'étiquette qui visualise title.

Voir aussi Personnaliser GroupBox.

title : string

Cette propriété contient le titre.

Le titre est généralement affiché au-dessus du cadre pour en résumer le contenu.