GroupBox QML Type

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

• Lista de todos los miembros, incluidos los heredados

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 disponer un grupo lógico de controles juntos, dentro de un marco visual titled. GroupBox no proporciona un diseño propio, sino que es necesario posicionar su contenido, por ejemplo, creando un RowLayout o un ColumnLayout.

Los elementos declarados como hijos de un GroupBox se asignan automáticamente al GroupBox contentItem. Los elementos creados dinámicamente deben estar explícitamente vinculados al elemento de contenido.

Si sólo se utiliza un elemento dentro de un GroupBox, éste cambiará de tamaño para ajustarse al tamaño implícito del elemento que contiene. Esto lo hace especialmente adecuado para su uso junto con layouts.

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

GroupBox comprobable

Aunque GroupBox no tiene una casilla de verificación incorporada, es sencillo crear un GroupBox comprobable emparejándolo con CheckBox.

Es un patrón común para activar o desactivar los hijos del groupbox cuando su casilla de verificación se activa o desactiva, pero depende de la aplicación decidir sobre el comportamiento de la casilla de verificación.

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

Ver también CheckBox, Personalizar 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 visualiza title.

Véase también Personalización de GroupBox.

title : string

Esta propiedad contiene el título.

El título se muestra normalmente encima del cuadro de grupo para resumir su contenido.