GroupBox QML Type
Marco visual y título para un grupo lógico de controles. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- implicitLabelHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitLabelWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - label : Item
- title : string
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.

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.

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.