Layout QML Type
Proporciona propiedades adjuntas para los elementos empujados en un GridLayout, RowLayout o ColumnLayout. Más...
| Import Statement: | import QtQuick.Layouts |
Propiedades adjuntas
- alignment : Qt.Alignment
- bottomMargin : real
(since QtQuick.Layouts 1.2) - column : int
- columnSpan : int
- fillHeight : bool
- fillWidth : bool
- horizontalStretchFactor : int
(since Qt 6.5) - leftMargin : real
(since QtQuick.Layouts 1.2) - margins : real
(since QtQuick.Layouts 1.2) - maximumHeight : real
- maximumWidth : real
- minimumHeight : real
- minimumWidth : real
- preferredHeight : real
- preferredWidth : real
- rightMargin : real
(since QtQuick.Layouts 1.2) - row : int
- rowSpan : int
- topMargin : real
(since QtQuick.Layouts 1.2) - useDefaultSizePolicy : enumeration
(since 6.8) - verticalStretchFactor : int
(since Qt 6.5)
Descripción detallada
Un objeto de tipo Layout se adjunta a los elementos hijos de la presentación para proporcionar información específica sobre el elemento. Las propiedades del objeto adjunto influyen en la disposición de los elementos.
Por ejemplo, puede especificar minimumWidth, preferredWidth, y maximumWidth si los valores por defecto no son satisfactorios.
Cuando se cambia el tamaño de una presentación, los elementos pueden crecer o reducirse. Debido a esto, los elementos tienen un minimum size, preferred size y un maximum size.
Si no se ha especificado explícitamente el tamaño mínimo de un elemento, el tamaño se establece en 0. Si no se ha especificado explícitamente el tamaño máximo de un elemento, el tamaño se establece en Number.POSITIVE_INFINITY.
Para los diseños, los tamaños mínimo y máximo implícitos dependen del contenido de los diseños.
Las propiedades fillWidth y fillHeight pueden ser true o false. Si son false, el tamaño del elemento se fijará en su tamaño preferido. En caso contrario, crecerá o disminuirá entre su tamaño mínimo y máximo a medida que se redimensione la presentación. Si hay varios elementos con fillWidth (o fillHeight) ajustado a true, la maquetación aumentará o reducirá el tamaño de los elementos en función de su tamaño preferido.
Para obtener más información sobre el algoritmo de diseño, consulte también Qt Quick Layouts Overview.
Nota: No vincules las propiedades x, y, anchura o altura de los elementos de una maquetación, ya que esto entraría en conflicto con los objetivos de la Maquetación, y además puede causar bucles de vinculación. El motor de maquetación utiliza las propiedades de anchura y altura para almacenar el tamaño actual de los elementos, calculado a partir de las propiedades adjuntas mínimo/preferido/máximo, y puede sobrescribirse cada vez que se maquetan los elementos. Utilice Layout.preferredWidth y Layout.preferredHeight, o implicitWidth y implicitHeight para especificar el tamaño preferido de los elementos.
Véase también GridLayout, RowLayout, y ColumnLayout.
Documentación de propiedades adjuntas
Layout.alignment : Qt.Alignment
Esta propiedad permite especificar la alineación de un elemento dentro de la(s) celda(s) que ocupa.
El valor por defecto es 0, lo que significa que será Qt.AlignVCenter | Qt.AlignLeft. Estos valores por defecto también se aplican si sólo se especifica una bandera horizontal o vertical: si sólo se especifica una bandera horizontal, la bandera vertical por defecto será Qt.AlignVCenter, y si sólo se especifica una bandera vertical, la bandera horizontal por defecto será Qt.AlignLeft.
Una alineación válida es una combinación de las siguientes banderas:
- Qt::AlignLeft
- Qt::AlignHCenter
- Qt::AlignRight
- Qt::AlignTop
- Qt::AlignVCenter
- Qt::AlignBottom
- Qt::AlignBaseline
Layout.bottomMargin : real [since QtQuick.Layouts 1.2]
Especifica el margen inferior exterior de un elemento. Si no se establece el valor, se utilizará el valor de margins.
Esta propiedad fue introducida en QtQuick.Layouts 1.2.
Véase también margins.
Layout.column : int
Esta propiedad permite especificar la posición de columna de un elemento en GridLayout.
Si tanto row como esta propiedad no están definidas, será el diseño el que asigne una celda al elemento.
El valor por defecto es 0.
Véase también row y columnSpan.
Layout.columnSpan : int
Esta propiedad permite especificar el espacio entre columnas de un elemento en GridLayout.
El valor por defecto es 1.
Véase también rowSpan y column.
Layout.fillHeight : bool
Si esta propiedad es true, el elemento será lo más alto posible respetando las restricciones dadas. Si la propiedad es false, el elemento tendrá una altura fija establecida en la altura preferida. El valor predeterminado depende de la política de tamaño implícita (incorporada) del elemento.
Nota: Por defecto, esta propiedad es true para los diseños.
Véase también fillWidth.
Layout.fillWidth : bool
Si esta propiedad es true, el elemento será lo más ancho posible respetando las restricciones dadas. Si la propiedad es false, el elemento tendrá una anchura fija establecida en la anchura preferida. El valor predeterminado depende de la política de tamaño implícita (incorporada) del elemento.
Nota: Por defecto, esta propiedad es true para los diseños.
Véase también fillHeight.
Layout.horizontalStretchFactor : int [since Qt 6.5]
Esta propiedad le permite especificar el factor de estiramiento horizontal. Por defecto, dos elementos idénticos dispuestos en un diseño lineal tendrán el mismo tamaño, pero si el primer elemento tiene un factor de estiramiento de 1 y el segundo elemento tiene un factor de estiramiento de 2, el primer elemento tratará de obtener 1/3 del espacio disponible, y el segundo tratará de obtener 2/3 del espacio disponible. Tenga en cuenta que, si se convierten exactamente en 1/3 y 2/3 del espacio disponible depende de sus sugerencias de tamaño. Esto se debe a que cuando, por ejemplo, un diseño horizontal se muestra con su anchura mínima, todos sus elementos secundarios tendrán también su anchura mínima.
Del mismo modo, cuando un diseño horizontal tiene su anchura preferida, todos los elementos hijos tendrán su anchura preferida, y cuando un diseño horizontal tiene su anchura máxima, todos los elementos hijos tendrán su anchura máxima. Esta estrategia se aplica independientemente de los factores de estiramiento individuales. Como consecuencia de esto, los factores de estiramiento sólo determinarán la tasa de crecimiento de los elementos hijo entre el rango preferredWidth y maximumWidth.
El valor por defecto es -1, lo que significa que no se aplica ningún factor de estiramiento.
Nota: Esto requiere que Layout::fillWidth tenga el valor true.
Esta propiedad se introdujo en Qt 6.5.
Véase también verticalStretchFactor.
Layout.leftMargin : real [since QtQuick.Layouts 1.2]
Especifica el margen izquierdo exterior de un elemento. Si no se establece el valor, se utilizará el valor de margins.
Esta propiedad fue introducida en QtQuick.Layouts 1.2.
Véase también margins.
Layout.margins : real [since QtQuick.Layouts 1.2]
Establece los márgenes fuera de un elemento para que todos tengan el mismo valor. El propio elemento no evalúa sus propios márgenes. Es responsabilidad del elemento padre decidir si quiere evaluar los márgenes.
Específicamente, los márgenes sólo son evaluados por ColumnLayout, RowLayout, GridLayout, y otros contenedores tipo layout, como SplitView, donde el tamaño efectivo de celda de un elemento se incrementará a medida que se incrementen los márgenes.
Por lo tanto, si un elemento con márgenes es hijo de otro Item, su posición, tamaño y tamaño implícito permanecerán inalterados.
La combinación de márgenes con alineación alineará el elemento incluyendo sus márgenes. Por ejemplo, un elemento centrado verticalmente con un margen superior de 1 y un margen inferior de 9 hará que la alineación efectiva del elemento dentro de la celda sea de 4 píxeles por encima del centro.
El valor por defecto es 0.
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Ver también leftMargin, topMargin, rightMargin, y bottomMargin.
Layout.maximumHeight : real
El valor por defecto es la altura máxima implícita del elemento.
Si el elemento es un diseño, la altura máxima implícita será la altura máxima que el diseño puede tener sin que ninguno de sus elementos crezca más allá de su altura máxima. La altura máxima implícita para cualquier otro elemento es Number.POSITIVE_INFINITY.
Establecer este valor a -1 restablecerá la altura a su altura máxima implícita.
Véase también minimumHeight y preferredHeight.
Layout.maximumWidth : real
Esta propiedad contiene la anchura máxima de un elemento en un diseño. El valor por defecto es la anchura máxima implícita del elemento.
Si el elemento es una maquetación, la anchura máxima implícita será la anchura máxima que la maquetación puede tener sin que ninguno de sus elementos crezca más allá de su anchura máxima. La anchura máxima implícita para cualquier otro elemento es Number.POSITIVE_INFINITY.
Establecer este valor en -1 restablecerá la anchura a su anchura máxima implícita.
Véase también minimumWidth y preferredWidth.
Layout.minimumHeight : real
Esta propiedad contiene la altura mínima de un elemento en un diseño. El valor por defecto es la altura mínima implícita del elemento.
Si el elemento es un diseño, la altura mínima implícita será la altura mínima que el diseño puede tener sin que ninguno de sus elementos se reduzca por debajo de su altura mínima. La altura mínima implícita para cualquier otro elemento es 0.
Establecer este valor a -1 restablecerá la altura a su altura mínima implícita.
Véase también preferredHeight y maximumHeight.
Layout.minimumWidth : real
Esta propiedad contiene la anchura mínima de un elemento en un diseño. El valor por defecto es la anchura mínima implícita del elemento.
Si el elemento es un diseño, la anchura mínima implícita será la anchura mínima que el diseño puede tener sin que ninguno de sus elementos se reduzca por debajo de su anchura mínima. La anchura mínima implícita para cualquier otro elemento es 0.
Establecer este valor a -1 restablecerá la anchura a su anchura mínima implícita.
Véase también preferredWidth y maximumWidth.
Layout.preferredHeight : real
Esta propiedad contiene la altura preferida de un elemento en un diseño. Si la altura preferida es -1 será ignorada, y el diseño utilizará implicitHeight en su lugar. Por defecto es -1.
Véase también minimumHeight y maximumHeight.
Layout.preferredWidth : real
Esta propiedad contiene la anchura preferida de un elemento en un diseño. Si la anchura preferida es -1 será ignorada, y el diseño utilizará implicitWidth en su lugar. Por defecto es -1.
Véase también minimumWidth y maximumWidth.
Layout.rightMargin : real [since QtQuick.Layouts 1.2]
Especifica el margen derecho exterior de un elemento. Si no se establece el valor, se utilizará el valor de margins.
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.row : int
Esta propiedad permite especificar la posición de fila de un elemento en GridLayout.
Si tanto column como esta propiedad no están establecidas, es el diseño el que debe asignar una celda al elemento.
El valor por defecto es 0.
Véase también column y rowSpan.
Layout.rowSpan : int
Esta propiedad permite especificar el espacio entre filas de un elemento en GridLayout.
El valor por defecto es 1.
Véase también columnSpan y row.
Layout.topMargin : real [since QtQuick.Layouts 1.2]
Especifica el margen superior exterior de un elemento. Si no se establece el valor, se utilizará el valor de margins.
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.useDefaultSizePolicy : enumeration [since 6.8]
Esta propiedad permite al usuario configurar la política de tamaño de diseño a nivel de componente.
El valor por defecto se heredará consultando el atributo de la aplicación Qt::AA_QtQuickUseDefaultSizePolicy. Puede utilizar esta propiedad para anular ese valor.
| Constante | Descripción |
|---|---|
Layout.SizePolicyImplicit | El elemento de la maqueta utiliza una política de tamaño implícita o incorporada |
Layout.SizePolicyExplicit | El elemento del diseño no utiliza políticas de tamaño implícitas. |
Esta propiedad se introdujo en Qt 6.8.
Layout.verticalStretchFactor : int [since Qt 6.5]
Esta propiedad le permite especificar el factor de estiramiento vertical. Por defecto, dos elementos idénticos dispuestos en una disposición lineal tendrán el mismo tamaño, pero si el primer elemento tiene un factor de estiramiento de 1 y el segundo elemento tiene un factor de estiramiento de 2, el primer elemento tratará de obtener 1/3 del espacio disponible, y el segundo tratará de obtener 2/3 del espacio disponible. Tenga en cuenta que, si se convierten exactamente en 1/3 y 2/3 del espacio disponible depende de sus sugerencias de tamaño. Esto se debe a que cuando, por ejemplo, un diseño vertical se muestra con su altura mínima, todos sus elementos secundarios tendrán también su altura mínima.
Del mismo modo, cuando un diseño vertical tiene su altura preferida, todos los elementos secundarios tendrán su altura preferida, y cuando un diseño vertical tiene su altura máxima, todos los elementos secundarios tendrán su altura máxima. Esta estrategia se aplica independientemente de cuáles sean los factores de estiramiento individuales. Como consecuencia de esto, los factores de estiramiento sólo determinarán la tasa de crecimiento de los elementos hijo entre el rango preferredHeight y maximumHeight.
El valor por defecto es -1, lo que significa que no se aplica ningún factor de estiramiento.
Nota: Esto requiere que Layout::fillHeight tenga el valor true.
Esta propiedad se introdujo en Qt 6.5.
Véase también horizontalStretchFactor.
© 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.
