QFormLayout Class

Documentation des fonctions membres

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

Crée une nouvelle mise en page de formulaire à l'aide du widget « parent » spécifié.

La mise en page est définie directement comme mise en page de niveau supérieur pour ` parent`. Il ne peut y avoir qu'une seule mise en page de niveau supérieur pour un widget. Elle est renvoyée par la fonction ` QWidget::layout()`.

Voir aussi ` QWidget::setLayout()`

[virtual noexcept] QFormLayout::~QFormLayout()

Cela perturbe 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 mise en page de formulaire, avec les éléments label et field indiqués.

Voir également insertRow().

void QFormLayout::addRow(QLayout *layout)

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

void QFormLayout::addRow(QWidget *widget)

Ajoute l'widget ion spécifiée à la fin de la mise en page de ce formulaire. L'widget ion 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, en arrière-plan, une ` QLabel ` dont le texte est « labelText ».

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

Cette surcharge crée automatiquement, en arrière-plan, une instance de ` QLabel ` dont le texte est ` labelText `. L'` field ` est définie comme la ` buddy` de la nouvelle ` 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 situé à l'adresse spécifiée index. Si index est hors limites, *rowPtr est défini à -1 ; sinon, la ligne est stockée dans *rowPtr et le rôle dans *rolePtr.

Voir également 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’ layout enfant spécifié. Si layout ne figure pas dans la mise en page du formulaire, *rowPtr est défini sur -1 ; dans le cas contraire, la ligne est stockée dans *rowPtr et le rôle 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'widget spécifié dans la mise en page. Si widget ne figure pas dans la mise en page, *rowPtr est défini sur -1 ; dans le cas contraire, la ligne est stockée dans *rowPtr et le rôle dans *rolePtr.

Voir également 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 mise en page de formulaire, avec les valeurs label et field indiquées. Si row est hors limites, la nouvelle ligne est ajoutée à la fin.

Voir également addRow().

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

Insère l'layout spécifiée à la position row dans la mise en page de ce formulaire. L'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'widget spécifiée à la position row dans cette mise en page de formulaire. L'widget s'étend sur les deux colonnes. Si row se trouve hors des 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, en arrière-plan, un fichier « QLabel » dont le texte est « labelText ».

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

Cette surcharge crée automatiquement, en arrière-plan, une instance de ` QLabel ` dont le texte est ` labelText `. L'` field ` est défini comme l'` buddy` de la nouvelle ` QLabel`.

[override virtual] void QFormLayout::invalidate()

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

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

Renvoie « true » si certains éléments de la ligne row sont visibles, sinon renvoie « false ».

Cette fonction a été introduite dans Qt 6.4.

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

Renvoie « true » si certains éléments de la ligne correspondant à layout sont visibles, sinon renvoie « false ».

Cette fonction a été introduite dans Qt 6.4.

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

Renvoie « true » si certains éléments de la ligne correspondant à widget sont visibles, sinon renvoie « false ».

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 présent dans l'row donné et correspondant à l'role (colonne) spécifiée. Renvoie « nullptr » si cet élément n'existe pas.

Voir également QLayout::itemAt() et setItem().

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

Renvoie le libellé associé à l'field donné.

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 mise en page de formulaire.

row La valeur doit être non négative et inférieure à rowCount().

Après cet appel, rowCount() est décrémenté d’une unité. Tous les widgets et mises en page imbriquées qui occupaient cette ligne sont supprimés. Cela inclut à la fois le ou les widgets 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 appel 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 mise en page de formulaire.

Après cet appel, rowCount() est décrémenté d’une unité. Tous les widgets et mises en page imbriquées qui occupaient cette ligne sont supprimés. Cela inclut à la fois le ou les widgets 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 appel 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 également takeRow().

void QFormLayout::removeRow(QWidget *widget)

Supprime la ligne correspondant à widget de cette mise en page de formulaire.

Après cet appel, la valeur de rowCount() est décrémentée d’un. Tous les widgets et mises en page imbriquées qui occupaient cette ligne sont supprimés. Cela inclut à la fois le ou les widgets 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 appel 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 de l'row spécifiée pour l'role indiquée sur item, en ajoutant des lignes vides à la mise en page si nécessaire.

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

Voir également setLayout().

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

Définit la sous-mise en page dans l'row indiquée pour l'role spécifiée sur layout, en étendant la mise en page du formulaire avec des lignes vides si nécessaire.

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

Remarque : pour la plupart des applications, il est préférable d’utiliser ` addRow()` ou ` insertRow()` plutôt que `setLayout()`.

Voir également ` setWidget()`.

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

Affiche la ligne row si on est vrai ; sinon, masque la ligne.

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

Cette fonction a été introduite dans Qt 6.4.

Voir également isRowVisible(), removeRow() et takeRow().

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

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

Cette fonction a été introduite dans Qt 6.4.

Voir également removeRow() et takeRow().

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

Affiche la ligne correspondant à widget si on est vrai ; sinon, masque 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 pour la propriété : QLayout::spacing.

Cette fonction définit l'espacement vertical et horizontal sur spacing.

Voir également spacing(), setVerticalSpacing() et setHorizontalSpacing().

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

Place le widget dans l'row spécifiée pour l'role spécifiée à l'adresse widget, en étendant la mise en page avec des lignes vides si nécessaire.

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

Remarque : pour la plupart des applications, il est préférable d’utiliser ` addRow()` ou ` insertRow()` plutôt que `setWidget()`.

Voir aussi ` 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 pour la propriété : QLayout::spacing.

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

Voir également 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'row spécifiée de la mise en page de ce formulaire.

row La valeur doit être non négative et inférieure à rowCount().

Après cet appel, la valeur de ` rowCount()` est décrémentée d’une unité. 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()`.

Renvoie 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 l'layout e spécifiée de cette mise en page de formulaire.

Après cet appel, la valeur de ` rowCount()` est décrémentée d'une unité. 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 mise en page du formulaire et effacer la mise en page insérée, utilisez plutôt removeRow().

Renvoie une structure contenant à la fois le widget et les éléments de mise en page d’étiquette correspondants

Voir également removeRow().

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

Supprime l'widget spécifiée de cette mise en page de formulaire.

Après cet appel, la valeur de ` rowCount()` est décrémentée d'une unité. 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 la fonction ` removeRow()`.

Renvoie : une structure contenant à la fois le widget et les éléments de mise en page d'étiquette correspondants

Voir aussi ` removeRow()`.