QGridLayout Class

Dokumentation der Mitgliedsfunktionen

[explicit] QGridLayout::QGridLayout(QWidget *parent = nullptr)

Konstruiert ein neues QGridLayout mit dem übergeordneten Widget parent. Das Layout hat zunächst eine Zeile und eine Spalte und wird erweitert, wenn neue Elemente eingefügt werden.

Das Layout wird direkt als Top-Level-Layout für parent festgelegt. Es kann nur ein Layout der obersten Ebene für ein Widget geben. Es wird von QWidget::layout() zurückgegeben.

Wenn parent nullptr ist, müssen Sie dieses Rasterlayout in ein anderes Layout einfügen oder es mit QWidget::setLayout() als Layout für ein Widget festlegen.

Siehe auch QWidget::setLayout().

[virtual noexcept] QGridLayout::~QGridLayout()

Zerstört das Rasterlayout. Die Geometrieverwaltung wird beendet, wenn es sich um ein Top-Level-Grid handelt.

Die Widgets des Layouts werden nicht zerstört.

[override virtual protected] void QGridLayout::addItem(QLayoutItem *item)

Reimplements: QLayout::addItem(QLayoutItem *item).

void QGridLayout::addItem(QLayoutItem *item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment alignment = Qt::Alignment())

Fügt item an der Position row, column ein, überspannt rowSpan Zeilen und columnSpan Spalten und richtet es gemäß alignment aus. Wenn rowSpan und/oder columnSpan den Wert -1 hat, reicht das Element bis zum unteren bzw. rechten Rand. Das Layout übernimmt das Eigentum an item.

void QGridLayout::addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment())

Platziert die layout an der Position (row, column) im Raster. Die obere linke Position ist (0, 0).

Die Ausrichtung wird durch alignment festgelegt. Die Standardausrichtung ist 0, was bedeutet, dass das Widget die gesamte Zelle ausfüllt.

Eine Ausrichtung ungleich Null zeigt an, dass das Layout nicht wachsen soll, um den verfügbaren Platz auszufüllen, sondern dass die Größe gemäß sizeHint() angepasst werden soll.

layout wird zu einem untergeordneten Element des Rasterlayouts.

void QGridLayout::addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

Dies ist eine überladene Funktion.

Diese Version fügt dem Zellenraster das Layout layout hinzu, das sich über mehrere Zeilen/Spalten erstreckt. Die Zelle beginnt bei row, column und erstreckt sich über rowSpan Zeilen und columnSpan Spalten.

Wenn rowSpan und/oder columnSpan gleich -1 ist, erstreckt sich das Layout bis zum unteren bzw. rechten Rand.

void QGridLayout::addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment())

Fügt die angegebene widget dem Zellengitter an row, column hinzu. Die linke obere Position ist standardmäßig (0, 0).

Die Ausrichtung wird durch alignment festgelegt. Die Standardausrichtung ist 0, was bedeutet, dass das Widget die gesamte Zelle ausfüllt.

void QGridLayout::addWidget(QWidget *widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

Dies ist eine überladene Funktion.

Diese Version fügt die angegebene widget in das Zellengitter ein, das sich über mehrere Zeilen/Spalten erstreckt. Die Zelle beginnt bei fromRow, fromColumn und erstreckt sich über rowSpan Zeilen und columnSpan Spalten. Die widget hat die angegebene alignment.

Wenn rowSpan und/oder columnSpan gleich -1 ist, erstreckt sich das Widget bis zum unteren bzw. rechten Rand.

QRect QGridLayout::cellRect(int row, int column) const

Gibt die Geometrie der Zelle mit der Zeile row und der Spalte column im Raster zurück. Gibt ein ungültiges Rechteck zurück, wenn row oder column außerhalb des Gitters liegt.

int QGridLayout::columnCount() const

Gibt die Anzahl der Spalten in diesem Grid zurück.

int QGridLayout::columnMinimumWidth(int column) const

Gibt den Spaltenabstand für die Spalte column zurück.

Siehe auch setColumnMinimumWidth().

int QGridLayout::columnStretch(int column) const

Gibt den Streckungsfaktor für die Spalte column zurück.

Siehe auch setColumnStretch().

[override virtual] int QGridLayout::count() const

Reimplements: QLayout::count() const.

[override virtual] Qt::Orientations QGridLayout::expandingDirections() const

Reimplements: QLayout::expandingDirections() const.

void QGridLayout::getItemPosition(int index, int *row, int *column, int *rowSpan, int *columnSpan) const

Gibt die Positionsinformationen des Elements mit der angegebenen index zurück.

Die als row und column übergebenen Variablen werden mit der Position des Elements im Layout aktualisiert, und die Variablen rowSpan und columnSpan werden mit den vertikalen und horizontalen Abständen des Elements aktualisiert.

Siehe auch itemAtPosition() und itemAt().

[override virtual] bool QGridLayout::hasHeightForWidth() const

Reimplements: QLayoutItem::hasHeightForWidth() const.

[override virtual] int QGridLayout::heightForWidth(int w) const

Reimplements: QLayoutItem::heightForWidth(int) const.

[override virtual] void QGridLayout::invalidate()

Reimplements: QLayout::invalidate().

[override virtual] QLayoutItem *QGridLayout::itemAt(int index) const

Reimplements: QLayout::itemAt(int index) const.

QLayoutItem *QGridLayout::itemAtPosition(int row, int column) const

Gibt das Layoutelement zurück, das die Zelle (row, column) belegt, oder nullptr, wenn die Zelle leer ist.

Siehe auch getItemPosition() und indexOf().

[override virtual] QSize QGridLayout::maximumSize() const

Reimplements: QLayout::maximumSize() const.

[override virtual] int QGridLayout::minimumHeightForWidth(int w) const

Reimplements: QLayoutItem::minimumHeightForWidth(int w) const.

[override virtual] QSize QGridLayout::minimumSize() const

Reimplements: QLayout::minimumSize() const.

Qt::Corner QGridLayout::originCorner() const

Gibt die Ecke zurück, die für den Ursprung des Gitters verwendet wird, d.h. für die Position (0, 0).

Siehe auch setOriginCorner().

int QGridLayout::rowCount() const

Gibt die Anzahl der Zeilen in diesem Gitter zurück.

int QGridLayout::rowMinimumHeight(int row) const

Gibt die für die Zeile row festgelegte Mindestbreite zurück.

Siehe auch setRowMinimumHeight().

int QGridLayout::rowStretch(int row) const

Gibt den Streckungsfaktor für die Zeile row zurück.

Siehe auch setRowStretch().

void QGridLayout::setColumnMinimumWidth(int column, int minSize)

Setzt die Mindestbreite der Spalte column auf minSize Pixel.

Siehe auch columnMinimumWidth() und setRowMinimumHeight().

void QGridLayout::setColumnStretch(int column, int stretch)

Setzt den Streckungsfaktor der Spalte column auf stretch. Die erste Spalte hat die Nummer 0.

Der Streckungsfaktor ist relativ zu den anderen Spalten in diesem Raster. Spalten mit einem höheren Dehnungsfaktor nehmen mehr Platz in Anspruch.

Der Standard-Dehnungsfaktor ist 0. Wenn der Dehnungsfaktor 0 ist und keine andere Spalte in dieser Tabelle überhaupt wachsen kann, kann die Spalte trotzdem wachsen.

Ein alternativer Ansatz ist das Hinzufügen von Abstand mit addItem() und QSpacerItem.

Siehe auch columnStretch() und setRowStretch().

[override virtual] void QGridLayout::setGeometry(const QRect &rect)

Reimplements: QLayout::setGeometry(const QRect &r).

void QGridLayout::setOriginCorner(Qt::Corner corner)

Setzt die Ursprungsecke des Gitters, d.h. die Position (0, 0), auf corner.

Siehe auch originCorner().

void QGridLayout::setRowMinimumHeight(int row, int minSize)

Setzt die Mindesthöhe der Zeile row auf minSize Pixel.

Siehe auch rowMinimumHeight() und setColumnMinimumWidth().

void QGridLayout::setRowStretch(int row, int stretch)

Setzt den Streckungsfaktor der Zeile row auf stretch. Die erste Zeile hat die Nummer 0.

Der Streckungsfaktor ist relativ zu den anderen Zeilen in diesem Raster. Zeilen mit einem höheren Dehnungsfaktor nehmen mehr Platz in Anspruch.

Der Standard-Dehnungsfaktor ist 0. Wenn der Dehnungsfaktor 0 ist und keine andere Zeile in dieser Tabelle überhaupt wachsen kann, kann die Zeile trotzdem wachsen.

Siehe auch rowStretch(), setRowMinimumHeight(), und setColumnStretch().

[override virtual] void QGridLayout::setSpacing(int spacing)

Reimplementiert eine Zugriffsfunktion für die Eigenschaft: QLayout::spacing.

Diese Funktion setzt sowohl die vertikalen als auch die horizontalen Abstände auf spacing.

Siehe auch spacing(), setVerticalSpacing(), und setHorizontalSpacing().

[override virtual] QSize QGridLayout::sizeHint() const

Reimplements: QLayoutItem::sizeHint() const.

[override virtual] int QGridLayout::spacing() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QLayout::spacing.

Wenn der vertikale Abstand gleich dem horizontalen Abstand ist, gibt diese Funktion diesen Wert zurück; andernfalls gibt sie -1 zurück.

Siehe auch setSpacing(), verticalSpacing(), und horizontalSpacing().

[override virtual] QLayoutItem *QGridLayout::takeAt(int index)

Reimplements: QLayout::takeAt(int index).