QGridLayout Class

Documentation des fonctions membres

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

Construit un nouveau QGridLayout avec le widget parent, parent. La grille comporte initialement une ligne et une colonne et s'étendra lorsque de nouveaux éléments seront insérés.

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().

Si parent est nullptr, vous devez insérer cette disposition de grille dans une autre disposition ou la définir comme disposition d'un widget à l'aide de QWidget::setLayout().

Voir aussi QWidget::setLayout().

[virtual noexcept] QGridLayout::~QGridLayout()

Détruit l'agencement de la grille. La gestion de la géométrie est interrompue s'il s'agit d'une grille de niveau supérieur.

Les widgets de la grille ne sont pas détruits.

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

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

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

Ajoute item à la position row, column, enjambant les lignes rowSpan et les colonnes columnSpan, et l'aligne conformément à alignment. Si rowSpan et/ou columnSpan est -1, l'élément s'étendra jusqu'au bord inférieur et/ou droit, respectivement. La mise en page s'approprie l'élément item.

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

Place le site layout à la position (row, column) dans la grille. La position en haut à gauche est (0, 0).

L'alignement est spécifié par alignment. L'alignement par défaut est 0, ce qui signifie que le widget remplit toute la cellule.

Un alignement non nul indique que la disposition ne doit pas s'agrandir pour remplir l'espace disponible, mais qu'elle doit être dimensionnée conformément à sizeHint().

layout devient un enfant de la disposition de la grille.

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

Cette version ajoute la disposition layout à la grille de cellules, qui s'étend sur plusieurs lignes/colonnes. La cellule commencera à row, column s'étendant sur rowSpan lignes et columnSpan colonnes.

Si rowSpan et/ou columnSpan vaut -1, la disposition s'étendra jusqu'au bord inférieur et/ou droit, respectivement.

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

Ajoute l'adresse widget à la grille de cellules à row, column. La position en haut à gauche est (0, 0) par défaut.

L'alignement est spécifié par alignment. L'alignement par défaut est 0, ce qui signifie que le widget remplit toute la cellule.

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

Cette version ajoute le site widget à la grille de cellules, sur plusieurs lignes/colonnes. La cellule commencera à fromRow, fromColumn s'étendant sur rowSpan lignes et columnSpan colonnes. L'adresse widget aura l'adresse alignment.

Si rowSpan et/ou columnSpan vaut -1, le widget s'étendra jusqu'au bord inférieur et/ou droit, respectivement.

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

Renvoie la géométrie de la cellule avec la ligne row et la colonne column dans la grille. Renvoie un rectangle non valide si row ou column est en dehors de la grille.

int QGridLayout::columnCount() const

Renvoie le nombre de colonnes de cette grille.

int QGridLayout::columnMinimumWidth(int column) const

Renvoie l'espacement des colonnes pour la colonne column.

Voir aussi setColumnMinimumWidth().

int QGridLayout::columnStretch(int column) const

Renvoie le facteur d'étirement pour la colonne column.

Voir aussi setColumnStretch().

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

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

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

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

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

Renvoie les informations relatives à la position de l'élément correspondant à l'adresse index.

Les variables passées comme row et column sont mises à jour avec la position de l'élément dans la mise en page, et les variables rowSpan et columnSpan sont mises à jour avec les portées verticales et horizontales de l'élément.

Voir aussi itemAtPosition() et itemAt().

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

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

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

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

[override virtual] void QGridLayout::invalidate()

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

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

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

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

Renvoie l'élément de mise en page qui occupe la cellule (row, column), ou nullptr si la cellule est vide.

Voir aussi getItemPosition() et indexOf().

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

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

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

Réimplémente : QLayoutItem::minimumHeightForWidth(int w) const.

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

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

Qt::Corner QGridLayout::originCorner() const

Renvoie le coin utilisé pour l'origine de la grille, c'est-à-dire pour la position (0, 0).

Voir aussi setOriginCorner().

int QGridLayout::rowCount() const

Renvoie le nombre de lignes de cette grille.

int QGridLayout::rowMinimumHeight(int row) const

Renvoie la largeur minimale définie pour la ligne row.

Voir également setRowMinimumHeight().

int QGridLayout::rowStretch(int row) const

Renvoie le facteur d'étirement pour la ligne row.

Voir également setRowStretch().

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

Fixe la largeur minimale de la colonne column à minSize pixels.

Voir aussi columnMinimumWidth() et setRowMinimumHeight().

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

Définit le facteur d'étirement de la colonne column à stretch. La première colonne porte le numéro 0.

Le facteur d'étirement est relatif aux autres colonnes de cette grille. Les colonnes dont le facteur d'étirement est plus élevé occupent une plus grande partie de l'espace disponible.

Le facteur d'étirement par défaut est de 0. Si le facteur d'étirement est de 0 et qu'aucune autre colonne de ce tableau ne peut croître, la colonne peut quand même croître.

Une autre approche consiste à ajouter de l'espace en utilisant addItem() avec QSpacerItem.

Voir également columnStretch() et setRowStretch().

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

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

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

Fixe le coin d'origine de la grille, c'est-à-dire la position (0, 0), à corner.

Voir aussi originCorner().

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

Fixe la hauteur minimale de la ligne row à minSize pixels.

Voir aussi rowMinimumHeight() et setColumnMinimumWidth().

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

Définit le facteur d'étirement de la ligne row à stretch. La première ligne porte le numéro 0.

Le facteur d'étirement est relatif aux autres lignes de cette grille. Les lignes dont le facteur d'étirement est plus élevé occupent une plus grande partie de l'espace disponible.

Le facteur d'étirement par défaut est de 0. Si le facteur d'étirement est de 0 et qu'aucune autre ligne de ce tableau ne peut croître, la ligne peut quand même croître.

Voir également rowStretch(), setRowMinimumHeight() et setColumnStretch().

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

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

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

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

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