QLayoutItem Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Layoutelement mit einem alignment. Nicht alle Unterklassen unterstützen die Ausrichtung.

[virtual noexcept] QLayoutItem::~QLayoutItem()

Zerstört die QLayoutItem.

Qt::Alignment QLayoutItem::alignment() const

Gibt die Ausrichtung dieses Elements zurück.

Siehe auch setAlignment().

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

Gibt den/die Kontrolltyp(en) für das Layoutelement zurück. Für ein QWidgetItem stammt der Kontrolltyp aus der Größenrichtlinie des Widgets; für ein QLayoutItem wird der Kontrolltyp aus dem Inhalt des Layouts abgeleitet.

Siehe auch QSizePolicy::controlType().

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

Gibt zurück, ob dieses Layoutelement mehr Platz als sizeHint() beanspruchen kann. Ein Wert von Qt::Vertical oder Qt::Horizontal bedeutet, dass es nur in einer Dimension wachsen will, während Qt::Vertical | Qt::Horizontal bedeutet, dass es in beiden Dimensionen wachsen will.

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

Gibt das Rechteck zurück, das von diesem Layoutelement abgedeckt wird.

Siehe auch setGeometry().

[virtual] bool QLayoutItem::hasHeightForWidth() const

Gibt true zurück, wenn die bevorzugte Höhe dieses Layouts von seiner Breite abhängt; andernfalls wird false zurückgegeben. Die Standardimplementierung gibt false zurück.

Reimplementieren Sie diese Funktion in Layoutmanagern, die Höhe für Breite unterstützen.

Siehe auch heightForWidth() und QWidget::heightForWidth().

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

Gibt die bevorzugte Höhe für dieses Layoutelement in Abhängigkeit von der Breite zurück, die in dieser Standardimplementierung nicht verwendet wird.

Die Standardimplementierung gibt -1 zurück und zeigt damit an, dass die bevorzugte Höhe unabhängig von der Breite des Elements ist. Die Verwendung der Funktion hasHeightForWidth() ist in der Regel wesentlich schneller als der Aufruf dieser Funktion und der Test auf -1.

Implementieren Sie diese Funktion in Layoutmanagern neu, die Höhe für Breite unterstützen. Eine typische Implementierung sieht wie folgt aus:

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;
}

Zwischenspeichern wird dringend empfohlen; ohne Zwischenspeichern wird das Layout exponentiell lange dauern.

Siehe auch hasHeightForWidth().

[virtual] void QLayoutItem::invalidate()

Macht alle zwischengespeicherten Informationen in diesem Layoutelement ungültig.

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

Wird in Unterklassen implementiert, um zurückzugeben, ob dieses Element leer ist, d. h. ob es irgendwelche Widgets enthält.

[virtual] QLayout *QLayoutItem::layout()

Wenn dieses Element ein QLayout ist, wird es als QLayout zurückgegeben; andernfalls wird nullptr zurückgegeben. Diese Funktion bietet ein typsicheres Casting.

Siehe auch spacerItem() und widget().

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

Wird in Unterklassen implementiert, um die maximale Größe dieses Elements zurückzugeben.

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

Gibt die Mindesthöhe zurück, die dieses Widget für die angegebene Breite benötigt, w. Die Standardimplementierung gibt einfach heightForWidth(w) zurück.

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

Wird in Unterklassen implementiert, um die Mindestgröße dieses Elements zurückzugeben.

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

Setzt die Ausrichtung dieses Elements auf alignment.

Hinweis: Die Ausrichtung von Elementen wird nur von QLayoutItem Unterklassen unterstützt, wo sie einen visuellen Effekt hat. Mit Ausnahme von QSpacerItem, das Leerraum für Layouts bereitstellt, unterstützen alle öffentlichen Qt-Klassen, die von QLayoutItem erben, die Ausrichtung von Elementen.

Siehe auch alignment().

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

Wird in Unterklassen implementiert, um die Geometrie dieses Elements auf r zu setzen.

Siehe auch geometry().

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

Wird in Unterklassen implementiert, um die bevorzugte Größe dieses Elements zurückzugeben.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Wenn dieses Element ein QSpacerItem ist, wird es als QSpacerItem zurückgegeben; andernfalls wird nullptr zurückgegeben. Diese Funktion bietet ein typsicheres Casting.

Siehe auch layout() und widget().

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

Wenn dieses Element ein QWidget verwaltet, wird dieses Widget zurückgegeben. Andernfalls wird nullptr zurückgegeben.

Siehe auch layout() und spacerItem().