QLayoutItem Class

Documentación de funciones miembro

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

Construye un elemento de diseño con un alignment. No todas las subclases soportan 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 el tipo o tipos de control del elemento de diseño. En el caso de QWidgetItem, el tipo de control procede de la política de tamaño del widget; en el caso de QLayoutItem, el tipo de control procede del contenido de la presentación.

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

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

Devuelve si este elemento de diseño puede utilizar más espacio que sizeHint(). Un valor de Qt::Vertical o Qt::Horizontal significa que quiere crecer en una sola dimensión, mientras que Qt::Vertical | Qt::Horizontal significa que quiere crecer en ambas dimensiones.

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

Devuelve el rectángulo cubierto por 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.

Reimplemente esta función en los gestores de maquetación que soporten la altura para 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, que no se utiliza en esta implementación por defecto.

La implementación por defecto devuelve -1, indicando que la altura preferida es independiente de la anchura del elemento. Utilizar la función hasHeightForWidth() suele ser mucho más rápido que llamar a esta función y comprobar si devuelve -1.

Reimplemente esta función en los gestores de diseño que soporten la altura para la anchura. 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 almacenamiento en caché; sin él, la maquetación tardará un tiempo exponencial.

Véase también hasHeightForWidth().

[virtual] void QLayoutItem::invalidate()

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

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

Implementado en subclases para devolver 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 QLayout; en caso contrario se devuelve nullptr. Esta función proporciona un moldeado seguro.

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

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

Implementado en subclases para devolver el tamaño máximo de este elemento.

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

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

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

Implementado en 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 sólo es soportada por las subclases de QLayoutItem donde tendría un efecto visual. Excepto QSpacerItem, que proporciona espacio en blanco para diseños, todas las clases Qt públicas que heredan de QLayoutItem soportan la alineación de elementos.

Véase también alignment().

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

Implementado en subclases para establecer la geometría de este elemento en r.

Véase también geometry().

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

Implementado en subclases para devolver el tamaño preferido de este elemento.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Si este elemento es un QSpacerItem, se devuelve como QSpacerItem; en caso contrario se devuelve nullptr. Esta función proporciona un moldeado seguro.

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

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

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

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