Layout QML Type
Proporciona propiedades asociadas para los elementos añadidos a un « GridLayout », « RowLayout » o « ColumnLayout ». Más...
| Import Statement: | import QtQuick.Layouts |
Propiedades asociadas
- 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
Se adjunta un objeto de tipo «Layout» a los elementos secundarios del diseño para proporcionar información específica del diseño sobre el elemento. Las propiedades del objeto adjunto influyen en la forma en que el diseño organizará los elementos.
Por ejemplo, puedes especificar minimumWidth, preferredWidth y maximumWidth si los valores predeterminados no te satisfacen.
Cuando se cambia el tamaño de un diseño, los elementos pueden aumentar o reducirse. Por este motivo, los elementos tienen un « minimum size », un « preferred size » y un « maximum size ».
Si no se ha especificado explícitamente un tamaño mínimo para un elemento, el tamaño se establece en 0. Si no se ha especificado explícitamente un tamaño máximo para un elemento, el tamaño se establece en Number.POSITIVE_INFINITY.
En el caso de los diseños, los tamaños mínimo y máximo implícitos dependen del contenido de los mismos.
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. De lo contrario, aumentará o disminuirá entre su tamaño mínimo y máximo a medida que se redimensione el diseño. Si hay varios elementos con « fillWidth » (o « fillHeight ») establecido en « true », el diseño ampliará o reducirá los elementos en proporción a su tamaño preferido.
Para obtener más detalles sobre el algoritmo de diseño, consulta también la Descripción general de diseños deQt Quick .
Nota: Nose deben vincular las propiedades x, y, width o height de los elementos de un diseño, ya que esto entraría en conflicto con los objetivos de Layout y también podría provocar bucles de vinculación. El motor de diseño utiliza las propiedades «width» y «height» para almacenar el tamaño actual de los elementos, calculado a partir de las propiedades asociadas «minimum», «preferred» y «maximum», y estas propiedades pueden sobrescribirse cada vez que se diseña la disposición de 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 sobre propiedades asociadas
Layout.alignment : Qt.Alignment [attached]
Esta propiedad te permite especificar la alineación de un elemento dentro de la celda o celdas que ocupa.
El valor por defecto es « 0 », lo que significa que se alineará « Qt.AlignVCenter | Qt.AlignLeft ». Estos valores por defecto también se aplican si solo se especifica un indicador horizontal o vertical: si solo se especifica un indicador horizontal, el indicador vertical por defecto será « Qt.AlignVCenter », y si solo se especifica un indicador vertical, el indicador horizontal por defecto será « Qt.AlignLeft ».
Una alineación válida es una combinación de los siguientes indicadores:
- Qt::AlignLeft
- Qt::AlignHCenter
- Qt::AlignRight
- Qt::AlignTop
- Qt::AlignVCenter
- Qt::AlignBottom
- Qt::AlignBaseline
Layout.bottomMargin : real [attached, since QtQuick.Layouts 1.2]
Especifica el margen inferior exterior de un elemento. Si no se establece ningún valor, se utilizará el valor de « margins ».
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.column : int [attached]
Esta propiedad te permite especificar la posición en la columna de un elemento en un « GridLayout ».
Si no se han definido ni « row » ni esta propiedad, corresponderá al diseño asignar una celda al elemento.
El valor por defecto es « 0 ».
Véase también « row » y « columnSpan ».
Layout.columnSpan : int [attached]
Esta propiedad te permite especificar el ancho de columna de un elemento en un GridLayout.
El valor por defecto es 1.
Véase también « rowSpan » y « column ».
Layout.fillHeight : bool [attached]
Si esta propiedad es « true », el elemento tendrá la mayor altura posible respetando las restricciones establecidas. Si la propiedad es « false », el elemento tendrá una altura fija establecida en la altura preferida. El valor por defecto depende de la política de tamaño implícita (integrada) del elemento.
Nota: Por defecto, esta propiedad es « true » para los diseños.
Véase también fillWidth.
Layout.fillWidth : bool [attached]
Si esta propiedad es « true », el elemento tendrá el mayor ancho posible, siempre que se respeten las restricciones establecidas. Si la propiedad es « false », el elemento tendrá un ancho fijo establecido en el ancho preferido. El valor por defecto depende de la política de tamaño implícita (integrada) del elemento.
Nota: De forma predeterminada, esta propiedad es « true » para los diseños.
Véase también fillHeight.
Layout.horizontalStretchFactor : int [attached, since Qt 6.5]
Esta propiedad te 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 expansión de 1 y el segundo de 2, el primero intentará ocupar 1/3 del espacio disponible, y el segundo , 2/3. Ten en cuenta que el hecho de que ocupen exactamente 1/3 y 2/3 del espacio disponible depende de sus valores de tamaño. Esto se debe a que, por ejemplo, cuando una disposición horizontal se muestra con su anchura mínima, todos sus elementos hijos también tendrán, en consecuencia, su anchura mínima.
Del mismo modo, cuando un diseño horizontal tiene su ancho preferido, todos los elementos hijos tendrán sus anchos preferidos, y cuando un diseño horizontal tiene su ancho máximo, todos los elementos hijos tendrán sus anchos máximos. Esta estrategia se aplica independientemente de cuáles sean los factores de expansión individuales. Como consecuencia de ello, los factores de expansión solo determinarán la tasa de crecimiento de los elementos secundarios dentro del rango comprendido entre preferredWidth y maximumWidth.
El valor por defecto es -1, lo que significa que no se aplica ningún factor de estiramiento.
Nota: Para ello es necesario que Layout::fillWidth esté establecido en true
Esta propiedad se introdujo en Qt 6.5.
Véase también verticalStretchFactor.
Layout.leftMargin : real [attached, since QtQuick.Layouts 1.2]
Especifica el margen izquierdo exterior de un elemento. Si no se establece ningún valor, se utilizará el valor de ` margins`.
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.margins : real [attached, since QtQuick.Layouts 1.2]
Establece que todos los márgenes exteriores de un elemento tengan el mismo valor. El propio elemento no calcula sus propios márgenes. Es responsabilidad del elemento padre decidir si desea calcular los márgenes.
Concretamente, los márgenes solo son evaluados por ColumnLayout, RowLayout, GridLayout y otros contenedores de tipo «layout», como SplitView, donde el tamaño efectivo de la celda de un elemento aumentará a medida que aumenten los márgenes.
Por lo tanto, si un elemento con márgenes es un elemento secundario de otro ` Item`, su posición, tamaño y tamaño implícito permanecerán inalterados.
La combinación de márgenes con la 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 quede 4 píxeles por encima del centro.
El valor por defecto es 0.
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también leftMargin, topMargin, rightMargin y bottomMargin.
Layout.maximumHeight : real [attached]
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 puede alcanzar el diseño sin que ninguno de sus elementos supere su altura máxima. La altura máxima implícita para cualquier otro elemento es Number.POSITIVE_INFINITY.
Si se establece este valor en -1, la altura se restablecerá a su altura máxima implícita.
Véase también minimumHeight y preferredHeight.
Layout.maximumWidth : real [attached]
Esta propiedad establece el ancho máximo de un elemento en un diseño. El valor por defecto es el ancho máximo implícito del elemento.
Si el elemento es un diseño, el ancho máximo implícito será el ancho máximo que puede tener el diseño sin que ninguno de sus elementos supere su ancho máximo. El ancho máximo implícito para cualquier otro elemento es Number.POSITIVE_INFINITY.
Al establecer este valor en -1, el ancho se restablecerá a su ancho máximo implícito.
Véase también minimumWidth y preferredWidth.
Layout.minimumHeight : real [attached]
Esta propiedad indica 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 puede tener el diseño 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.
Si se establece este valor en -1, la altura se restablecerá a su altura mínima implícita.
Véase también preferredHeight y maximumHeight.
Layout.minimumWidth : real [attached]
Esta propiedad establece el ancho mínimo de un elemento en un diseño. El valor por defecto es el ancho mínimo implícito del elemento.
Si el elemento es un diseño, el ancho mínimo implícito será el ancho mínimo que puede tener el diseño sin que ninguno de sus elementos se reduzca por debajo de su ancho mínimo. El ancho mínimo implícito para cualquier otro elemento es 0.
Si se establece este valor en -1, el ancho se restablecerá a su ancho mínimo implícito.
Véase también preferredWidth y maximumWidth.
Layout.preferredHeight : real [attached]
Esta propiedad establece la altura preferida de un elemento en un diseño. Si la altura preferida es « -1 », se ignorará y el diseño utilizará en su lugar « implicitHeight ». El valor por defecto es « -1 ».
Véase también « minimumHeight » y « maximumHeight ».
Layout.preferredWidth : real [attached]
Esta propiedad establece el ancho preferido de un elemento en un diseño. Si el ancho preferido es « -1 », se ignorará y el diseño utilizará « implicitWidth » en su lugar. El valor por defecto es « -1 ».
Véase también minimumWidth y maximumWidth.
Layout.rightMargin : real [attached, since QtQuick.Layouts 1.2]
Especifica el margen derecho fuera de un elemento. Si no se establece ningún valor, se utilizará el valor de « margins ».
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.row : int [attached]
Esta propiedad te permite especificar la posición en la fila de un elemento en un « GridLayout ».
Si ni « column » ni esta propiedad están configuradas, corresponderá al diseño asignar una celda al elemento.
El valor por defecto es « 0 ».
Véase también « column » y « rowSpan ».
Layout.rowSpan : int [attached]
Esta propiedad te permite especificar el ancho de fila de un elemento en un GridLayout.
El valor predeterminado es 1.
Véase también « columnSpan » y « row ».
Layout.topMargin : real [attached, since QtQuick.Layouts 1.2]
Especifica el margen superior fuera de un elemento. Si no se establece ningún valor, se utilizará el valor de « margins ».
Esta propiedad se introdujo en QtQuick.Layouts 1.2.
Véase también margins.
Layout.useDefaultSizePolicy : enumeration [attached, since 6.8]
Esta propiedad permite al usuario configurar la política de tamaño del diseño a nivel de componente.
El valor por defecto se heredará al consultar el atributo de la aplicación « Qt::AA_QtQuickUseDefaultSizePolicy ». Puedes utilizar esta propiedad para anular dicho valor.
| Constante | Descripción |
|---|---|
Layout.SizePolicyImplicit | El elemento del diseño utiliza una política de tamaño implícita o integrada |
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 [attached, since Qt 6.5]
Esta propiedad te permite especificar el factor de estiramiento vertical. 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 expansión de 1 y el segundo de 2, el primero intentará ocupar 1/3 del espacio disponible, y el segundo , 2/3. Ten en cuenta que el hecho de que ocupen exactamente 1/3 y 2/3 del espacio disponible depende de sus indicaciones de tamaño. Esto se debe a que, por ejemplo, cuando un diseño vertical se muestra con su altura mínima, todos sus elementos secundarios también tendrán, en consecuencia, su altura mínima.
Del mismo modo, cuando un diseño vertical tiene su altura preferida, todos los elementos secundarios tendrán sus alturas preferidas, y cuando un diseño vertical tiene su altura máxima, todos los elementos secundarios tendrán sus alturas máximas. Esta estrategia se aplica independientemente de cuáles sean los factores de estiramiento individuales. Como consecuencia de ello, los factores de estiramiento solo determinarán la tasa de crecimiento de los elementos secundarios dentro del rango comprendido entre preferredHeight y maximumHeight.
El valor por defecto es -1, lo que significa que no se aplica ningún factor de estiramiento.
Nota: Para ello es necesario que Layout::fillHeight esté establecido en 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.