Pane QML Type

Proporciona un fondo que coincide con el estilo y el tema de la aplicación. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• contentChildren : list<Item>
• contentData : list<QtObject>
• contentHeight : real
• contentWidth : real

Descripción detallada

Pane proporciona un color de fondo que coincide con el estilo y el tema de la aplicación. Pane 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 panel se vinculan automáticamente al contentItem del panel. Los elementos creados dinámicamente deben vincularse explícitamente al contentItem.

Como se menciona en Event Handling, el Panel no permite que los eventos de clic y toque se transmitan a los elementos situados debajo de él. Si wheelEnabled es true, lo mismo se aplica a los eventos de la rueda del ratón.

Tamaño del contenido

Si sólo se utiliza un único elemento dentro de un Panel, se redimensionará para ajustarse al tamaño implícito de su elemento contenido. Esto lo hace especialmente adecuado para su uso junto con diseños.

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

A veces puede haber dos elementos dentro del panel:

Pane {
    SwipeView {
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
}

En este caso, Pane no puede calcular un tamaño implícito razonable. Como estamos anclando el PageIndicator sobre el SwipeView, podemos simplemente establecer el tamaño del contenido al tamaño implícito de la vista:

Pane {
    contentWidth: view.implicitWidth
    contentHeight: view.implicitHeight

    SwipeView {
        id: view
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
 }

Si contentItem no tiene tamaño implícito y sólo tiene un hijo, Pane utilizará el tamaño implícito de ese hijo. Por ejemplo, en el siguiente código, el Pane asume el tamaño del Rectángulo:

Pane {
    Item {
        Rectangle {
            implicitWidth: 200
            implicitHeight: 200
            color: "salmon"
        }
    }
}

Ver también Personalización de Pane, Controles Contenedores, Gestión del Foco en Qt Quick Controls, y Event Handling.

Documentación de Propiedades

contentChildren : list<Item>

Esta propiedad contiene la lista de hijos del contenido.

La lista contiene todos los elementos que han sido declarados en QML como hijos del panel.

Véase también Item::children y contentData.

contentData : list<QtObject> [default]

Esta propiedad contiene la lista de datos de contenido.

La lista contiene todos los objetos que han sido declarados en QML como hijos del panel.

Véase también Item::data y contentChildren.

contentHeight : real

Esta propiedad contiene la altura del contenido. Se utiliza para calcular la altura total implícita del panel.

Para más información, consulte Content Sizing.

Véase también contentWidth.

contentWidth : real

Esta propiedad contiene el ancho del contenido. Se utiliza para calcular el ancho total implícito del panel.

Para más información, consulte Content Sizing.

Véase también contentHeight.