QFormLayout Class

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt ein neues Formularlayout mit dem angegebenen Widget „ parent “.

Das Layout wird direkt als oberstes Layout für „ parent “ festgelegt. Für ein Widget kann es nur ein oberstes Layout 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)

Implementiert erneut: ` QLayout::addItem` (`QLayoutItem *item`).

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

Fügt am Ende dieses Formularlayouts eine neue Zeile mit den angegebenen Werten „ label “ und „ field “ hinzu.

Siehe auch insertRow().

void QFormLayout::addRow(QLayout *layout)

Fügt das angegebene „ layout “ am Ende dieses Formularlayouts ein. Das „ layout “ erstreckt sich über beide Spalten.

void QFormLayout::addRow(QWidget *widget)

Fügt das angegebene „ widget “ am Ende dieses Formularlayouts ein. Das „ widget “ erstreckt sich über beide Spalten.

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

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

Diese Überladung erstellt im Hintergrund automatisch einen „ QLabel “ mit dem Text „ labelText “.

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

Diese Überladung erstellt im Hintergrund automatisch eine „ QLabel “ mit dem Text „ labelText “. Die „ field “ wird als „ buddy “ der neuen „ QLabel “ festgelegt.

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

Implementiert erneut: ` QLayout::count()` const.

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

Implementiert erneut: ` QLayout::expandingDirections()` const.

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

Ruft die Zeile und die Rolle (Spalte) des Elements an der angegebenen Adresse index ab. Liegt index außerhalb des zulässigen Bereichs, wird *rowPtr 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. Befindet sich layout nicht im Formularlayout, wird *rowPtr 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 die Rolle (Spalte) des angegebenen „ widget “ im Layout ab. Befindet sich „ widget “ nicht im Layout, wird „*rowPtr “ 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

Implementiert neu: ` QLayoutItem::hasHeightForWidth()` const.

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

Implementiert neu: ` QLayoutItem::heightForWidth(int) const`.

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

Fügt an der Position „ row “ in diesem Formularlayout eine neue Zeile ein, mit den angegebenen Werten „ label “ und „ field “. Liegt „ row “ außerhalb des zulässigen Bereichs, wird die neue Zeile am Ende hinzugefügt.

Siehe auch addRow().

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

Fügt das angegebene Element „ layout “ an der Position „ row “ in dieses Formularlayout ein. Das Element „ layout “ erstreckt sich über beide Spalten. Liegt „ row “ außerhalb des zulässigen Bereichs, wird das Widget am Ende hinzugefügt.

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

Fügt das angegebene „ widget “ an der Position „ row “ in dieses Formularlayout ein. Das „ widget “ erstreckt sich über beide Spalten. Liegt „ row “ außerhalb des zulässigen Bereichs, wird das Widget am Ende hinzugefügt.

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

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

Diese Überladung erstellt im Hintergrund automatisch ein „ QLabel “ mit dem Text „ labelText “.

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

Diese Überladung erstellt im Hintergrund automatisch eine „ QLabel “ mit dem Text „ labelText “. Die „ field “ wird als „ buddy “ des neuen „ QLabel “ festgelegt.

[override virtual] void QFormLayout::invalidate()

Implementiert: 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 „false“.

Diese Funktion wurde in Qt 6.4 eingeführt.

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

Gibt „true“ zurück, wenn einige Elemente in der Zeile, die „ layout “ entspricht, sichtbar sind; andernfalls wird „false“ zurückgegeben.

Diese Funktion wurde in Qt 6.4 eingeführt.

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

Gibt „true“ zurück, wenn einige Elemente in der Zeile, die „ widget “ entspricht, sichtbar sind; andernfalls wird „false“ zurückgegeben.

Diese Funktion wurde in Qt 6.4 eingeführt.

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

Implementiert: ` QLayout::itemAt(int index) const`.

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

Gibt das Layout-Element im angegebenen „ row “ mit der angegebenen „ role “ (Spalte) zurück. Gibt „ nullptr “ zurück, wenn kein solches Element vorhanden ist.

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

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

Gibt die Bezeichnung zurück, die dem angegebenen „ field “ zugeordnet ist.

Siehe auch itemAt().

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

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

Implementiert: ` 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 verringert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegt haben, werden gelöscht. Dazu gehören sowohl die Feld-Widgets als auch die Beschriftung, falls vorhanden. Alle nachfolgenden Zeilen werden um eine Zeile nach oben verschoben, und der frei gewordene vertikale Platz wird auf die verbleibenden Zeilen verteilt.

Sie können diese Funktion verwenden, um einen vorherigen Aufruf von ` 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)

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

Nach diesem Aufruf wird „ rowCount()“ um eins verringert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegt haben, werden gelöscht. Dazu gehören sowohl die Feld-Widgets 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 neu verteilt.

Sie können diese Funktion verwenden, um einen vorherigen Aufruf von ` 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)

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

Nach diesem Aufruf wird „ rowCount()“ um eins verringert. Alle Widgets und verschachtelten Layouts, die diese Zeile belegt haben, werden gelöscht. Dazu gehören sowohl die Feld-Widgets als auch die Beschriftung, falls vorhanden. Alle nachfolgenden Zeilen werden um eine Zeile nach oben verschoben, und der frei gewordene vertikale Platz wird auf die verbleibenden Zeilen verteilt.

Sie können diese Funktion verwenden, um einen vorherigen Aufruf von „ 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)

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

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

Setzt das Element im angegebenen „ row “ für das angegebene „ role “ auf „ item “ und erweitert das Layout dabei bei Bedarf um leere Zeilen.

Ist die Zelle bereits belegt, wird die „ item “ nicht eingefügt und eine Fehlermeldung an die Konsole gesendet. Das „ item “ erstreckt sich über beide Spalten.

Siehe auch ` setLayout()`.

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

Legt das Unterlayout im angegebenen „ row “ für das angegebene „ role “ auf „ layout “ fest und erweitert das Formularlayout dabei bei Bedarf um leere Zeilen.

Ist die Zelle bereits belegt, wird das ` layout ` nicht eingefügt und eine Fehlermeldung an die Konsole gesendet.

Hinweis: Für die meisten Anwendungen sollten „ 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, andernfalls 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)

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)

Zeigt die Zeile an, die „ widget “ entspricht, wenn „ on “ wahr ist; andernfalls wird die Zeile ausgeblendet.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch removeRow() und takeRow().

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QLayout::spacing “ neu.

Diese Funktion setzt sowohl den vertikalen als auch den horizontalen Abstand auf „ spacing “.

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

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

Setzt das Widget im angegebenen „ row “ für die angegebene „ role “ auf „ widget “ und erweitert das Layout bei Bedarf um leere Zeilen.

Ist die Zelle bereits belegt, wird das ` widget ` nicht eingefügt und eine Fehlermeldung an die Konsole gesendet.

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

Siehe auch ` setLayout()`.

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

Implementiert: QLayoutItem::sizeHint() const.

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QLayout::spacing “ neu.

Ist der vertikale Abstand gleich dem horizontalen Abstand, 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)

Implementiert: 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 verringert. Alle nachfolgenden Zeilen werden um eine Zeile nach oben verschoben, und der frei gewordene vertikale Platz wird auf die verbleibenden Zeilen verteilt.

Sie können diese Funktion verwenden, um einen vorherigen Aufruf von ` 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()`.

Gibt eine Struktur zurück, die sowohl das Widget als auch die zugehörigen Beschriftungs-Layoutelemente enthält

Siehe auch ` removeRow()`.

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

Entfernt das angegebene „ layout “ aus diesem Formularlayout.

Nach diesem Aufruf wird ` rowCount()` um eins verringert. Alle nachfolgenden Zeilen werden um eine Zeile nach oben verschoben, und der frei gewordene vertikale Platz wird auf die verbleibenden Zeilen verteilt.

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 möchten, verwenden Sie stattdessen „ removeRow()“.

Gibt eine Struktur zurück, die sowohl das Widget als auch die zugehörigen Beschriftungs-Layoutelemente enthält

Siehe auch removeRow().

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

Entfernt das angegebene „ widget “ aus diesem Formularlayout.

Nach diesem Aufruf wird „ rowCount()“ um eins verringert. Alle nachfolgenden Zeilen werden um eine Zeile nach oben verschoben, und der frei gewordene vertikale Platz wird auf die verbleibenden Zeilen verteilt.

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 möchten, verwenden Sie stattdessen ` removeRow()`.

Gibt eine Struktur zurück, die sowohl das Widget als auch die zugehörigen Beschriftungs-Layoutelemente enthält

Siehe auch ` removeRow()`.