GroupBox QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Frame

Propriétés

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.

Propriété Documentation

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é définit 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 de la boîte de groupe pour résumer son contenu.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.