En esta página

GroupBox QML Type

Marco visual y título para un grupo lógico de controles. Más...

Import Statement: import QtQuick.Controls
Inherits:

Frame

Propiedades

Descripción detallada

GroupBox se utiliza para organizar un grupo lógico de controles juntos, dentro de un marco visual titled. GroupBox no proporciona un diseño propio, sino que requiere que se posicione su contenido, por ejemplo, creando un RowLayout o un ColumnLayout.

Los elementos declarados como hijos de un GroupBox se vinculan automáticamente al contentItem del GroupBox. Los elementos creados dinámicamente deben vincularse explícitamente al contentItem.

Si solo se utiliza un elemento dentro de un GroupBox, este se redimensionará para adaptarse al tamaño implícito del elemento que contiene. Esto lo hace especialmente adecuado para su uso junto con diseños.

Cuadro de grupo con título y borde que contiene casillas de selección

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

GroupBox con casillas de selección

Aunque el GroupBox no dispone de casilla de selección integrada, es muy sencillo crear un GroupBox con casilla de selección combinándolo con un CheckBox.

Cuadro de grupo con casilla de selección en el título

Es un patrón habitual habilitar o deshabilitar los elementos hijos del GroupBox al activar o desactivar su casilla de verificación, pero corresponde a la aplicación decidir el comportamiento de dicha casilla.

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

Véase también « CheckBox» , «Personalización de GroupBox» y «Controles contenedores».

Documentación de propiedades

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

Esta propiedad contiene la altura implícita de la etiqueta.

El valor es igual a ` label ? label.implicitHeight : 0`.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitLabelWidth.

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

Esta propiedad contiene el ancho implícito de la etiqueta.

El valor es igual a label ? label.implicitWidth : 0.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Véase también implicitLabelHeight.

label : Item

Esta propiedad contiene el elemento de etiqueta que muestra « title ».

Véase también Personalización deGroupBox.

title : string

Esta propiedad contiene el título.

El título suele aparecer encima del cuadro de grupo para resumir su contenido.

© 2026 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.