En esta página

QLayoutItem Class

La clase QLayoutItem proporciona un elemento abstracto que puede ser manipulado por un ` QLayout `. Más información...

Encabezado: #include <QLayoutItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado por:

QLayout, QSpacerItem y QWidgetItem

Funciones públicas

QLayoutItem(Qt::Alignment alignment = Qt::Alignment())
virtual ~QLayoutItem()
Qt::Alignment alignment() const
virtual QSizePolicy::ControlTypes controlTypes() const
virtual Qt::Orientations expandingDirections() const = 0
virtual QRect geometry() const = 0
virtual bool hasHeightForWidth() const
virtual int heightForWidth(int) const
virtual void invalidate()
virtual bool isEmpty() const = 0
virtual QLayout *layout()
virtual QSize maximumSize() const = 0
virtual int minimumHeightForWidth(int w) const
virtual QSize minimumSize() const = 0
void setAlignment(Qt::Alignment alignment)
virtual void setGeometry(const QRect &r) = 0
virtual QSize sizeHint() const = 0
virtual QSpacerItem *spacerItem()
virtual QWidget *widget() const

Descripción detallada

Se utiliza en diseños personalizados.

Se proporcionan funciones virtuales puras para devolver información sobre el diseño, entre las que se incluyen: ` sizeHint()`, ` minimumSize()`, ` maximumSize()` y ` expandingDirections()`.

La geometría del diseño se puede establecer y recuperar con setGeometry() y geometry(), y su alineación con setAlignment() y alignment().

isEmpty() devuelve si el elemento del diseño está vacío. Si el elemento concreto es un ` QWidget`, se puede recuperar mediante ` widget()`. Lo mismo ocurre con ` layout()` y ` spacerItem()`.

Algunos diseños presentan interdependencias entre el ancho y la altura. Estas pueden expresarse mediante hasHeightForWidth(), heightForWidth() y minimumHeightForWidth(). Para obtener más información, consulta el artículo de Qt Quarterly «Trading Height for Width».

Véase también QLayout.

Documentación de funciones miembro

[explicit] QLayoutItem::QLayoutItem(Qt::Alignment alignment = Qt::Alignment())

Crea un elemento de diseño con un ` alignment`. No todas las subclases admiten la alineación.

[virtual noexcept] QLayoutItem::~QLayoutItem()

Destruye el « QLayoutItem ».

Qt::Alignment QLayoutItem::alignment() const

Devuelve la alineación de este elemento.

Véase también ` setAlignment()`.

[virtual] QSizePolicy::ControlTypes QLayoutItem::controlTypes() const

Devuelve los tipos de control del elemento de diseño. En el caso de un ` QWidgetItem`, el tipo de control se deriva de la política de tamaño del widget; en el caso de un ` QLayoutItem`, los tipos de control se derivan del contenido del diseño.

Véase también QSizePolicy::controlType().

[pure virtual] Qt::Orientations QLayoutItem::expandingDirections() const

Devuelve si este elemento de diseño puede ocupar más espacio que lo que devuelve la función ` sizeHint()`. Un valor de ` Qt::Vertical ` o ` Qt::Horizontal ` significa que solo quiere expandirse en una dimensión, mientras que ` Qt::Vertical ` | ` Qt::Horizontal ` significa que quiere expandirse en ambas dimensiones.

[pure virtual] QRect QLayoutItem::geometry() const

Devuelve el rectángulo que abarca este elemento de diseño.

Véase también setGeometry().

[virtual] bool QLayoutItem::hasHeightForWidth() const

Devuelve « true » si la altura preferida de este diseño depende de su anchura; en caso contrario, devuelve « false ». La implementación por defecto devuelve «false».

Reimplementa esta función en los gestores de diseño que admitan la altura en función de la anchura.

Véase también heightForWidth() y QWidget::heightForWidth().

[virtual] int QLayoutItem::heightForWidth(int) const

Devuelve la altura preferida para este elemento de diseño, dada la anchura, aunque esta no se utiliza en esta implementación predeterminada.

La implementación predeterminada devuelve -1, lo que indica que la altura preferida es independiente del ancho del elemento. Utilizar la función hasHeightForWidth() suele ser mucho más rápido que llamar a esta función y comprobar si el valor es -1.

Reimplementa esta función en los gestores de diseño que admitan la altura en función del ancho. Una implementación típica tendría este aspecto:

int MyLayout::heightForWidth(int w) const
{
    if (cache_dirty || cached_width != w) {
        MyLayout *that = const_cast<MyLayout *>(this);
        int h = calculateHeightForWidth(w);
        that->cached_hfw = h;
        return h;
    }
    return cached_hfw;
}

Se recomienda encarecidamente el uso del almacenamiento en caché; sin él, el diseño tardará un tiempo exponencial.

Véase también hasHeightForWidth().

[virtual] void QLayoutItem::invalidate()

Anula cualquier información almacenada en la caché de este elemento de diseño.

[pure virtual] bool QLayoutItem::isEmpty() const

Se implementa en las subclases para indicar si este elemento está vacío, es decir, si contiene algún widget.

[virtual] QLayout *QLayoutItem::layout()

Si este elemento es un ` QLayout`, se devuelve como un ` QLayout`; en caso contrario, se devuelve ` nullptr `. Esta función proporciona una conversión segura en cuanto al tipo.

Véanse también spacerItem() y widget().

[pure virtual] QSize QLayoutItem::maximumSize() const

Se implementa en las subclases para devolver el tamaño máximo de este elemento.

[virtual] int QLayoutItem::minimumHeightForWidth(int w) const

Devuelve la altura mínima que necesita este widget para el ancho dado, w. La implementación por defecto simplemente devuelve heightForWidth(w).

[pure virtual] QSize QLayoutItem::minimumSize() const

Se implementa en las subclases para devolver el tamaño mínimo de este elemento.

void QLayoutItem::setAlignment(Qt::Alignment alignment)

Establece la alineación de este elemento en « alignment ».

Nota: La alineación de elementos solo es compatible con las subclases de ` QLayoutItem ` en las que tenga un efecto visual. Excepto ` QSpacerItem`, que proporciona un espacio en blanco para los diseños, todas las clases públicas de Qt que heredan de ` QLayoutItem ` admiten la alineación de elementos.

Véase también alignment().

[pure virtual] void QLayoutItem::setGeometry(const QRect &r)

Se implementa en las subclases para establecer la geometría de este elemento en r.

Véase también geometry().

[pure virtual] QSize QLayoutItem::sizeHint() const

Se implementa en las subclases para devolver el tamaño preferido de este elemento.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Si este elemento es de tipo ` QSpacerItem`, se devuelve como ` QSpacerItem`; en caso contrario, se devuelve ` nullptr `. Esta función proporciona una conversión segura en cuanto al tipo.

Véanse también layout() y widget().

[virtual] QWidget *QLayoutItem::widget() const

Si este elemento gestiona un ` QWidget`, devuelve ese widget. En caso contrario, se devuelve ` nullptr `.

Nota: Aunque las funciones layout() y spacerItem() realizan conversiones de tipo, esta función devuelve otro objeto: QLayout y QSpacerItem heredan de QLayoutItem, mientras que QWidget no.

Véanse también layout() y spacerItem().

© 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.