LayoutItemProxy QML Type
La clase `LayoutItemProxy` proporciona un marcador de posición para los elementos ` QQuickItem` en los diseños. Más información...
| Import Statement: | import QtQuick.Layouts |
| Since: | QtQuick.Layouts 6.6 |
| Inherits: |
Propiedades
- target : Item
Descripción detallada
Algunos diseños adaptativos requieren jerarquías de diseño diferentes para distintos tamaños de pantalla, pero la jerarquía de diseño es la misma que la estructura QML y, por lo tanto, no se puede modificar en tiempo de ejecución. LayoutItemProxy supera esta limitación representando un elemento « target » dentro del diseño. El propio elemento « target » puede definirse en cualquier lugar de la jerarquía QML. Esto permite declarar varios diseños con los mismos elementos de contenido. Los diseños pueden mostrarse y ocultarse para alternar entre ellos.
El `LayoutItemProxy` intentará tomar el control del elemento ` target ` si este se encuentra en modo « visible ». Al tomar el control, se posicionará y redimensionará el elemento ` target ` para que coincida con la posición y el tamaño del `LayoutItemProxy`. Además, el `LayoutItemProxy` se establecerá a sí mismo como padre del ` target ` (para garantizar la entrega de eventos y un orden de dibujo adecuado) y establecerá la visibilidad en « true ». Varios `LayoutItemProxies` pueden target el mismo elemento, pero solo un `LayoutItemProxy` puede controlar un elemento a la vez. Por lo tanto, solo uno de los proxies dirigidos al mismo elemento debería estar visible en cada momento. Si varios proxies apuntan al mismo elemento, pero la propiedad «visible» está establecida en «false» para cada uno de ellos, el elemento también será invisible.
Todas las propiedades adjuntas « Layout » de « target », así como « QQuickItem::implicitWidth » y « QQuickItem::implicitHeight » de « target », son reenviadas por el «LayoutItemProxy». El «LayoutItemProxy» imitará al « target » lo más fielmente posible en cuanto a las propiedades « Layout » y al tamaño. Las propiedades adjuntas « Layout » también pueden establecerse explícitamente en el «LayoutItemProxy», lo que detendrá el reenvío de las propiedades « target ».
Ejemplo de uso
Este es un ejemplo minimalista en el que se alterna entre dos diseños utilizando proxies para emplear los mismos elementos en ambos diseños. Los elementos que rellenan los diseños pueden definirse en cualquier punto de la estructura QML.
Rectangle {
id: rectangle1
color: "tomato"
Layout.fillHeight: true
Layout.fillWidth: true
}
Rectangle {
id: rectangle2
color: "lightskyblue"
Layout.fillHeight: true
Layout.fillWidth: true
}A continuación, podemos definir los diseños con LayoutItemProxys
GridLayout {
id: l1
columns: 1
visible: false
anchors.fill: parent
LayoutItemProxy { target: rectangle1 }
LayoutItemProxy { target: rectangle2 }
}
GridLayout {
id: l2
columns: 2
visible: true
anchors.fill: parent
LayoutItemProxy { target: rectangle1 }
LayoutItemProxy { target: rectangle2 }
}Ahora podemos alternar entre los diseños, en función de un criterio de nuestra elección, activando y desactivando la visibilidad de los diseños.
onWidthChanged: {
if (width < 300) {
l2.visible = false
l1.visible = true
} else {
l1.visible = false
l2.visible = true
}
}Los dos diseños resultantes tienen este aspecto:

El `LayoutItemProxy` también se puede utilizar sin diseños, por ejemplo, anclándolo a diferentes elementos. También es posible mezclar elementos reales de ` Items ` con elementos proxy, así como estructuras anidadas de diseños y elementos.
Advertencia: El ` LayoutItemProxy` establecerá como padre de su elemento de destino a sí mismo. Ten esto en cuenta al hacer referencia al padre del elemento de destino.
Véase también Item, GridLayout, RowLayout y ColumnLayout.
Documentación de propiedades
target : Item
Esta propiedad contiene el « Item » que el proxy debe representar en una jerarquía « Layout ».
© 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.