QFormLayout Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein neues Formularlayout mit dem angegebenen parent widget.

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

Siehe auch QWidget::setLayout().

[virtual noexcept] QFormLayout::~QFormLayout()

Zerstört das Formularlayout.

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

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

void QFormLayout::addRow(QWidget *label, QWidget *field)

Fügt eine neue Zeile am unteren Rand dieses Formularlayouts hinzu, mit der angegebenen label und field.

Siehe auch insertRow().

void QFormLayout::addRow(QLayout *layout)

Dies ist eine überladene Funktion.

Fügt die angegebene layout am Ende dieses Formularlayouts ein. Die layout erstreckt sich über beide Spalten.

void QFormLayout::addRow(QWidget *widget)

Dies ist eine überladene Funktion.

Fügt die angegebene widget am Ende dieses Formularlayouts ein. Die widget erstreckt sich über beide Spalten.

void QFormLayout::addRow(QWidget *label, QLayout *field)

Dies ist eine überladene Funktion.

void QFormLayout::addRow(const QString &labelText, QLayout *field)

Dies ist eine überladene Funktion.

Diese Überladung erstellt automatisch hinter den Kulissen eine QLabel mit labelText als Text.

void QFormLayout::addRow(const QString &labelText, QWidget *field)

Dies ist eine überladene Funktion.

Diese Überladung erstellt im Hintergrund automatisch ein QLabel mit labelText als Text. Die field wird als buddy des neuen QLabel eingestellt.

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

Reimplements: QLayout::count() const.

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

Reimplements: QLayout::expandingDirections() const.

void QFormLayout::getItemPosition(int index, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Ruft die Zeile und die Rolle (Spalte) des Eintrags unter der angegebenen Adresse index ab. Wenn index außerhalb der Grenzen liegt, * wirdrowPtr auf -1 gesetzt; andernfalls wird die Zeile in *rowPtr und die Rolle in *rolePtr gespeichert.

Siehe auch itemAt(), count(), getLayoutPosition(), und getWidgetPosition().

void QFormLayout::getLayoutPosition(QLayout *layout, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Ruft die Zeile und die Rolle (Spalte) des angegebenen untergeordneten Elements layout ab. Wenn layout nicht im Formularlayout enthalten ist, * wirdrowPtr auf -1 gesetzt; andernfalls wird die Zeile in *rowPtr und die Rolle in *rolePtr gespeichert.

void QFormLayout::getWidgetPosition(QWidget *widget, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

Ruft die Zeile und Rolle (Spalte) der angegebenen widget im Layout ab. Wenn widget nicht im Layout enthalten ist, * wirdrowPtr auf -1 gesetzt; andernfalls wird die Zeile in *rowPtr und die Rolle in *rolePtr gespeichert.

Siehe auch getItemPosition() und itemAt().

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

Reimplements: QLayoutItem::hasHeightForWidth() const.

[override virtual] int QFormLayout::heightForWidth(int width) const

Reimplements: QLayoutItem::heightForWidth(int) const.

void QFormLayout::insertRow(int row, QWidget *label, QWidget *field)

Fügt eine neue Zeile an der Position row in dieses Formularlayout ein, mit den angegebenen label und field. Wenn row außerhalb der Grenzen liegt, wird die neue Zeile am Ende hinzugefügt.

Siehe auch addRow().

void QFormLayout::insertRow(int row, QLayout *layout)

Dies ist eine überladene Funktion.

Fügt den angegebenen layout an der Position row in dieses Formularlayout ein. Die layout erstreckt sich über beide Spalten. Wenn row außerhalb der Grenzen liegt, wird das Widget am Ende eingefügt.

void QFormLayout::insertRow(int row, QWidget *widget)

Dies ist eine überladene Funktion.

Fügt den angegebenen widget an der Position row in dieses Formularlayout ein. Die widget erstreckt sich über beide Spalten. Wenn row außerhalb der Grenzen liegt, wird das Widget am Ende eingefügt.

void QFormLayout::insertRow(int row, QWidget *label, QLayout *field)

Dies ist eine überladene Funktion.

void QFormLayout::insertRow(int row, const QString &labelText, QLayout *field)

Dies ist eine überladene Funktion.

Diese Überladung erstellt automatisch hinter den Kulissen eine QLabel mit labelText als Text.

void QFormLayout::insertRow(int row, const QString &labelText, QWidget *field)

Dies ist eine überladene Funktion.

Diese Überladung erstellt im Hintergrund automatisch ein QLabel mit labelText als Text. Die field wird als buddy des neuen QLabel eingestellt.

[override virtual] void QFormLayout::invalidate()

Reimplements: QLayout::invalidate().

[since 6.4] bool QFormLayout::isRowVisible(int row) const

Gibt true zurück, wenn einige Elemente in der Zeile row sichtbar sind, andernfalls wird false zurückgegeben.

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.4] bool QFormLayout::isRowVisible(QLayout *layout) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn einige Elemente in der Zeile, die layout entspricht, sichtbar sind, andernfalls gibt sie false zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.4] bool QFormLayout::isRowVisible(QWidget *widget) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn einige Elemente in der Zeile, die widget entspricht, sichtbar sind, andernfalls gibt sie false zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

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

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

QLayoutItem *QFormLayout::itemAt(int row, QFormLayout::ItemRole role) const

Gibt das Layoutelement im angegebenen row mit der angegebenen role (Spalte) zurück. Gibt nullptr zurück, wenn es kein solches Element gibt.

Siehe auch QLayout::itemAt() und setItem().

QWidget *QFormLayout::labelForField(QWidget *field) const

Gibt das Label zurück, das mit dem angegebenen field verbunden ist.

Siehe auch itemAt().

QWidget *QFormLayout::labelForField(QLayout *field) const

Dies ist eine überladene Funktion.

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

Reimplements: QLayout::minimumSize() const.

void QFormLayout::removeRow(int row)

Löscht die Zeile row aus diesem Formularlayout.

row muss nicht-negativ und kleiner als rowCount() sein.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegten, werden gelöscht. Dies gilt sowohl für das/die Feld-Widget(s) als auch für die Beschriftung, falls vorhanden. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

Sie können diese Funktion verwenden, um eine vorherige addRow() oder insertRow() rückgängig zu machen:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(2); // le == nullptr at this point

Wenn Sie die Zeile aus dem Layout entfernen möchten, ohne die Widgets zu löschen, verwenden Sie stattdessen takeRow().

Siehe auch takeRow().

void QFormLayout::removeRow(QLayout *layout)

Dies ist eine überladene Funktion.

Löscht die Zeile, die layout entspricht, aus diesem Formularlayout.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegten, werden gelöscht. Dazu gehören sowohl das/die Feld-Widget(s) als auch die Beschriftung, falls vorhanden. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

Sie können diese Funktion verwenden, um eine vorherige addRow() oder insertRow() rückgängig zu machen:

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
flay->removeRow(layout); // vbl == nullptr at this point

Wenn Sie die Zeile aus dem Formularlayout entfernen möchten, ohne das eingefügte Layout zu löschen, verwenden Sie stattdessen takeRow().

Siehe auch takeRow().

void QFormLayout::removeRow(QWidget *widget)

Dies ist eine überladene Funktion.

Löscht die Zeile, die widget entspricht, aus diesem Formularlayout.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegten, werden gelöscht. Dazu gehören sowohl das/die Feld-Widget(s) als auch die Beschriftung, falls vorhanden. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

Sie können diese Funktion verwenden, um eine vorherige addRow() oder insertRow() rückgängig zu machen:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(le); // le == nullptr at this point

Wenn Sie die Zeile aus dem Layout entfernen möchten, ohne die Widgets zu löschen, verwenden Sie stattdessen takeRow().

Siehe auch takeRow().

int QFormLayout::rowCount() const

Gibt die Anzahl der Zeilen im Formular zurück.

Siehe auch QLayout::count().

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

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

void QFormLayout::setItem(int row, QFormLayout::ItemRole role, QLayoutItem *item)

Setzt das Element in der angegebenen row für die angegebene role auf item und erweitert das Layout gegebenenfalls um leere Zeilen.

Wenn die Zelle bereits belegt ist, wird item nicht eingefügt und eine Fehlermeldung wird an die Konsole gesendet. Die item erstreckt sich über beide Spalten.

Siehe auch setLayout().

void QFormLayout::setLayout(int row, QFormLayout::ItemRole role, QLayout *layout)

Setzt das Unterlayout im angegebenen row für das angegebene role auf layout und erweitert das Formularlayout gegebenenfalls um leere Zeilen.

Wenn die Zelle bereits belegt ist, wird layout nicht eingefügt und eine Fehlermeldung wird an die Konsole gesendet.

Hinweis: Für die meisten Anwendungen sollte addRow() oder insertRow() anstelle von setLayout() verwendet werden.

Siehe auch setWidget().

[since 6.4] void QFormLayout::setRowVisible(int row, bool on)

Zeigt die Zeile row an, wenn on wahr ist, ansonsten wird die Zeile ausgeblendet.

row muss nicht-negativ und kleiner als rowCount() sein.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch isRowVisible(), removeRow(), und takeRow().

[since 6.4] void QFormLayout::setRowVisible(QLayout *layout, bool on)

Dies ist eine überladene Funktion.

Zeigt die Zeile an, die layout entspricht, wenn on wahr ist, andernfalls wird die Zeile ausgeblendet.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch removeRow() und takeRow().

[since 6.4] void QFormLayout::setRowVisible(QWidget *widget, bool on)

Dies ist eine überladene Funktion.

Zeigt die Zeile an, die widget entspricht, wenn on wahr ist, andernfalls verbirgt sie die Zeile.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch removeRow() und takeRow().

[override virtual] void QFormLayout::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().

void QFormLayout::setWidget(int row, QFormLayout::ItemRole role, QWidget *widget)

Setzt das Widget in der angegebenen row für die angegebene role auf widget und erweitert das Layout ggf. um leere Zeilen.

Wenn die Zelle bereits belegt ist, wird widget nicht eingefügt und eine Fehlermeldung wird an die Konsole gesendet.

Hinweis: Für die meisten Anwendungen sollte addRow() oder insertRow() anstelle von setWidget() verwendet werden.

Siehe auch setLayout().

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

Reimplements: QLayoutItem::sizeHint() const.

[override virtual] int QFormLayout::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 *QFormLayout::takeAt(int index)

Reimplements: QLayout::takeAt(int index).

QFormLayout::TakeRowResult QFormLayout::takeRow(int row)

Entfernt das angegebene row aus diesem Formularlayout.

row muss nicht-negativ und kleiner als rowCount() sein.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

Sie können diese Funktion verwenden, um eine vorherige addRow() oder insertRow() rückgängig zu machen:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(2);

Wenn Sie die Zeile aus dem Layout entfernen und die Widgets löschen möchten, verwenden Sie stattdessen removeRow().

Rückgabe Eine Struktur, die sowohl das Widget als auch die entsprechenden Etiketten-Layoutelemente enthält

Siehe auch removeRow().

QFormLayout::TakeRowResult QFormLayout::takeRow(QLayout *layout)

Dies ist eine überladene Funktion.

Entfernt das angegebene layout aus diesem Formularlayout.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

Wenn Sie die Zeile aus dem Formularlayout entfernen und das eingefügte Layout löschen wollen, verwenden Sie stattdessen removeRow().

Rückgabe Eine Struktur, die sowohl das Widget als auch die entsprechenden Etikettenlayoutelemente enthält.

Siehe auch removeRow().

QFormLayout::TakeRowResult QFormLayout::takeRow(QWidget *widget)

Dies ist eine überladene Funktion.

Entfernt das angegebene widget aus diesem Formularlayout.

Nach diesem Aufruf wird rowCount() um eins dekrementiert. Alle folgenden Zeilen werden um eine Zeile nach oben verschoben und der freigewordene vertikale Platz wird auf die verbleibenden Zeilen umverteilt.

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

Wenn Sie die Zeile aus dem Layout entfernen und die Widgets löschen wollen, verwenden Sie stattdessen removeRow().

Rückgabe Eine Struktur, die sowohl das Widget als auch die entsprechenden Etiketten-Layoutelemente enthält.

Siehe auch removeRow().