Pane QML Type
Ofrece un fondo que combina con el estilo y la temática de la aplicación. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: | Frame, GroupBox, Page, ScrollView, and ToolBar |
Propiedades
- contentChildren : list<Item>
- contentData : list<QtObject>
- contentHeight : real
- contentWidth : real
Descripción detallada
El Pane proporciona un color de fondo que se adapta al estilo y al tema de la aplicación. El 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 Pane se asocian automáticamente al contentItem del Pane. Los elementos creados dinámicamente deben asociarse explícitamente al contentItem.
Tal y como se menciona en Event Handling, Pane no permite que los eventos de clic y táctiles lleguen a los elementos que se encuentran debajo de él. Si wheelEnabled es true, lo mismo se aplica a los eventos de la rueda del ratón.
Dimensionamiento del contenido
Si solo se utiliza un elemento dentro de un Pane, 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.

Pane {
ColumnLayout {
anchors.fill: parent
CheckBox { text: qsTr("E-mail") }
CheckBox { text: qsTr("Calendar") }
CheckBox { text: qsTr("Contacts") }
}
}En ocasiones, puede haber dos elementos dentro del Pane:
Pane {
SwipeView {
// ...
}
PageIndicator {
anchors.horizontalCenter: parent.horizontalCenter
anchors.bottom: parent.bottom
}
}En este caso, el Pane no puede calcular un tamaño implícito razonable. Dado que estamos anclando el elemento « PageIndicator » sobre el « SwipeView », podemos simplemente establecer el tamaño del contenido en el 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 el « contentItem » no tiene un tamaño implícito y solo tiene un elemento secundario, «Pane» utilizará el tamaño implícito de ese elemento secundario. Por ejemplo, en el código siguiente, «Pane» asume el tamaño del «Rectangle»:
Véase también Personalización de Pane, Controles contenedores, Gestión del foco en los controles de Qt Quick y Event Handling.
Documentación de propiedades
contentChildren : list<Item>
Esta propiedad contiene la lista de elementos hijos de contenido.
La lista contiene todos los elementos que se han declarado en QML como elementos secundarios del panel.
Nota: A diferencia de ` contentData`, ` contentChildren ` no incluye objetos QML no visuales.
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 se han declarado en QML como hijos del panel.
Nota: A diferencia de « contentChildren », « contentData » sí incluye objetos QML no visuales.
Véase también Item::data y contentChildren.
contentHeight : real
Esta propiedad almacena la altura del contenido. Se utiliza para calcular la altura implícita total del panel.
Para obtener más información, consulta Content Sizing.
Véase también contentWidth.
contentWidth : real
Esta propiedad almacena el ancho del contenido. Se utiliza para calcular el ancho implícito total del panel.
Para obtener más información, consulta Content Sizing.
Véase también contentHeight.
© 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.