QFormLayout Class

Documentation des fonctions membres

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

Construit une nouvelle présentation de formulaire avec le widget parent donné.

La disposition est définie directement comme la disposition de premier niveau pour parent. Il ne peut y avoir qu'une seule présentation de premier niveau pour un widget. Elle est renvoyée par QWidget::layout().

Voir aussi QWidget::setLayout().

[virtual noexcept] QFormLayout::~QFormLayout()

Détruit la mise en page du formulaire.

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

Réimplémente : QLayout::addItem(QLayoutItem *item).

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

Ajoute une nouvelle ligne au bas de cette présentation de formulaire, avec les données label et field.

Voir aussi insertRow().

void QFormLayout::addRow(QLayout *layout)

Ajoute l'adresse layout spécifiée à la fin de la mise en page de ce formulaire. Le site layout s'étend sur les deux colonnes.

void QFormLayout::addRow(QWidget *widget)

Ajoute l'adresse widget spécifiée à la fin de la mise en page de ce formulaire. Le site widget s'étend sur les deux colonnes.

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

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

Cette surcharge crée automatiquement un QLabel dans les coulisses avec labelText comme texte.

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

Cette surcharge crée automatiquement un QLabel en coulisses avec labelText comme texte. Le field est défini comme le nouveau buddy de QLabel.

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

Réimplémente : QLayout::count() const.

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

Réimplémente : QLayout::expandingDirections() const.

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

Récupère la ligne et le rôle (colonne) de l'élément à l'adresse spécifiée index. Si index est hors limites, *rowPtr est mis à -1 ; sinon la ligne est stockée dans *rowPtr et le rôle est stocké dans *rolePtr.

Voir aussi itemAt(), count(), getLayoutPosition() et getWidgetPosition().

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

Récupère la ligne et le rôle (colonne) de l'enfant spécifié layout. Si layout ne figure pas dans la présentation du formulaire, *rowPtr prend la valeur -1 ; sinon, la ligne est stockée dans *rowPtr et le rôle est stocké dans *rolePtr.

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

Récupère la ligne et le rôle (colonne) de l'adresse widget spécifiée dans la mise en page. Si widget n'est pas dans la disposition, *rowPtr est mis à -1 ; sinon la ligne est stockée dans *rowPtr et le rôle est stocké dans *rolePtr.

Voir aussi getItemPosition() et itemAt().

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

Réimplémente : QLayoutItem::hasHeightForWidth() const.

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

Réimplémente : QLayoutItem::heightForWidth(int) const.

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

Insère une nouvelle ligne à la position row dans cette présentation de formulaire, avec les données label et field. Si row est hors limites, la nouvelle ligne est ajoutée à la fin.

Voir aussi addRow().

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

Insère l'adresse layout spécifiée à la position row dans cette mise en page de formulaire. Le layout s'étend sur les deux colonnes. Si row est hors limites, le widget est ajouté à la fin.

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

Insère l'adresse widget spécifiée à la position row dans cette mise en page de formulaire. Le widget s'étend sur les deux colonnes. Si row est hors limites, le widget est ajouté à la fin.

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

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

Cette surcharge crée automatiquement un QLabel dans les coulisses avec labelText comme texte.

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

Cette surcharge crée automatiquement un QLabel en coulisses avec labelText comme texte. Le field est défini comme le nouveau buddy de QLabel.

[override virtual] void QFormLayout::invalidate()

Réimplémente : QLayout::invalidate().

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

Retourne vrai si certains éléments de la ligne row sont visibles, sinon retourne faux.

Cette fonction a été introduite dans Qt 6.4.

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

Renvoie un message vrai si certains éléments de la ligne correspondant à layout sont visibles, sinon il renvoie un message faux.

Cette fonction a été introduite dans Qt 6.4.

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

Renvoie un message vrai si certains éléments de la ligne correspondant à widget sont visibles, sinon il renvoie un message faux.

Cette fonction a été introduite dans Qt 6.4.

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

Réimplémente : QLayout::itemAt(int index) const.

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

Renvoie l'élément de mise en page dans l'adresse row donnée avec l'adresse role (colonne) spécifiée. Renvoie nullptr s'il n'existe pas d'élément de ce type.

Voir aussi QLayout::itemAt() et setItem().

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

Renvoie l'étiquette associée à l'adresse field.

Voir aussi itemAt().

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

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

Réimplémente : QLayout::minimumSize() const.

void QFormLayout::removeRow(int row)

Supprime la ligne row de cette présentation de formulaire.

row doit être non négatif et inférieur à rowCount().

Après cet appel, rowCount() est décrémenté de un. Tous les widgets et les dispositions imbriquées qui occupaient cette ligne sont supprimés. Cela inclut le(s) widget(s) de champ et l'étiquette, le cas échéant. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

Vous pouvez utiliser cette fonction pour annuler un précédent addRow() ou insertRow() :

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

Si vous souhaitez supprimer la ligne de la mise en page sans supprimer les widgets, utilisez plutôt takeRow().

Voir également takeRow().

void QFormLayout::removeRow(QLayout *layout)

Supprime la ligne correspondant à layout de cette présentation de formulaire.

Après cet appel, rowCount() est décrémenté de un. Tous les widgets et les dispositions imbriquées qui occupaient cette ligne sont supprimés. Cela inclut le(s) widget(s) de champ et l'étiquette, le cas échéant. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

Vous pouvez utiliser cette fonction pour annuler un précédent addRow() ou insertRow() :

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

Si vous souhaitez supprimer la ligne de la mise en page du formulaire sans supprimer la mise en page insérée, utilisez plutôt takeRow().

Voir aussi takeRow().

void QFormLayout::removeRow(QWidget *widget)

Supprime la ligne correspondant à widget de cette présentation de formulaire.

Après cet appel, rowCount() est décrémenté de un. Tous les widgets et les dispositions imbriquées qui occupaient cette ligne sont supprimés. Cela inclut le(s) widget(s) de champ et l'étiquette, le cas échéant. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

Vous pouvez utiliser cette fonction pour annuler un précédent addRow() ou insertRow() :

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

Si vous souhaitez supprimer la ligne de la mise en page sans supprimer les widgets, utilisez plutôt takeRow().

Voir également takeRow().

int QFormLayout::rowCount() const

Renvoie le nombre de lignes du formulaire.

Voir aussi QLayout::count().

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

Réimplémente : QLayout::setGeometry(const QRect &r).

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

Définit l'élément dans la cellule row pour la cellule role à item, en étendant la mise en page avec des lignes vides si nécessaire.

Si la cellule est déjà occupée, le item n'est pas inséré et un message d'erreur est envoyé à la console. Le item s'étend sur les deux colonnes.

Voir aussi setLayout().

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

Définit la disposition secondaire dans la cellule row pour la cellule role à layout, en étendant la disposition du formulaire avec des lignes vides si nécessaire.

Si la cellule est déjà occupée, layout n'est pas inséré et un message d'erreur est envoyé à la console.

Remarque : pour la plupart des applications, addRow() ou insertRow() doit être utilisé à la place de setLayout().

Voir également setWidget().

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

Affiche la ligne row si on est vrai, sinon cache la ligne.

row doit être non négatif et inférieur à rowCount().

Cette fonction a été introduite dans Qt 6.4.

Voir aussi isRowVisible(), removeRow(), et takeRow().

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

Affiche la ligne correspondant à layout si on est vrai, sinon cache la ligne.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi removeRow() et takeRow().

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

Affiche la ligne correspondant à widget si on est vrai, sinon cache la ligne.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi removeRow() et takeRow().

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

Réimplémente une fonction d'accès à la propriété : QLayout::spacing.

Cette fonction fixe l'espacement vertical et horizontal à spacing.

Voir aussi spacing(), setVerticalSpacing() et setHorizontalSpacing().

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

Définit le widget dans la cellule row pour la cellule role à widget, en étendant la disposition avec des lignes vides si nécessaire.

Si la cellule est déjà occupée, le widget n'est pas inséré et un message d'erreur est envoyé à la console.

Remarque : pour la plupart des applications, addRow() ou insertRow() doit être utilisé à la place de setWidget().

Voir également setLayout().

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

Réimplémente : QLayoutItem::sizeHint() const.

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

Réimplémente une fonction d'accès à la propriété : QLayout::spacing.

Si l'espacement vertical est égal à l'espacement horizontal, cette fonction renvoie cette valeur ; sinon, elle renvoie -1.

Voir aussi setSpacing(), verticalSpacing() et horizontalSpacing().

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

Réimplémente : QLayout::takeAt(int index).

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

Supprime l'adresse row spécifiée de cette présentation de formulaire.

row doit être non négatif et inférieur à rowCount().

Après cet appel, rowCount() est décrémenté de un. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

Vous pouvez utiliser cette fonction pour annuler un appel précédent à addRow() ou insertRow() :

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

Si vous souhaitez supprimer la ligne de la mise en page et supprimer les widgets, utilisez plutôt removeRow().

Retourne une structure contenant à la fois le widget et les éléments de mise en page de l'étiquette correspondante

Voir également removeRow().

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

Supprime le site layout spécifié de cette présentation de formulaire.

Après cet appel, rowCount() est décrémenté de un. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

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

Si vous souhaitez supprimer la ligne de la présentation du formulaire et supprimer la présentation insérée, utilisez plutôt removeRow().

Retourne une structure contenant à la fois le widget et les éléments de mise en page de l'étiquette correspondante

Voir également removeRow().

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

Supprime le site widget spécifié de cette présentation de formulaire.

Après cet appel, rowCount() est décrémenté de un. Toutes les lignes suivantes sont décalées d'une ligne vers le haut et l'espace vertical libéré est redistribué entre les lignes restantes.

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

Si vous souhaitez supprimer la ligne de la mise en page et supprimer les widgets, utilisez plutôt removeRow().

Retourne une structure contenant à la fois le widget et les éléments de mise en page de l'étiquette correspondante.

Voir également removeRow().