QGridLayout Class

Documentation des fonctions membres

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

Crée un nouveau QGridLayout avec le widget parent, parent. La disposition comporte initialement une ligne et une colonne, et s'étendra à mesure que de nouveaux éléments seront insérés.

La disposition est définie directement comme disposition de niveau supérieur pour parent. Il ne peut y avoir qu’une seule disposition de niveau supérieur pour un widget. Elle est renvoyée par la méthode QWidget::layout().

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

Voir également QWidget::setLayout().

[virtual noexcept] QGridLayout::~QGridLayout()

Détruit la mise en page en 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 mise en page 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, sur rowSpan lignes et columnSpan colonnes, et l'aligne selon alignment. Si rowSpan et/ou columnSpan est égal à -1, l'élément s'étendra respectivement jusqu'au bord inférieur et/ou droit. La mise en page prend en charge la gestion de item.

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

Place l'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 occupe toute la cellule.

Un alignement différent de zéro indique que la disposition ne doit pas s'étendre pour remplir l'espace disponible, mais doit être redimensionnée en fonction de ` sizeHint()`.

layout devient un enfant de la mise en page 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 mise en page « layout » à la grille de cellules, couvrant plusieurs lignes et colonnes. La cellule commencera à « row », « column » et s'étendra sur « rowSpan » lignes et « columnSpan » colonnes.

Si rowSpan et/ou columnSpan est égal à -1, la mise en page s'étendra respectivement jusqu'au bord inférieur et/ou droit.

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

Ajoute l'widget donné à la grille de cellules à l'adresse 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 occupe toute la cellule.

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

Cette version ajoute l'widget spécifiée à la grille de cellules, en s'étendant sur plusieurs lignes et colonnes. La cellule commencera à fromRow, fromColumn et s'étendra sur rowSpan lignes et columnSpan colonnes. L'widget aura la valeur spécifiée alignment.

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

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

Renvoie la géométrie de la cellule située à la ligne row et à la colonne column dans la grille. Renvoie un rectangle non valide si row ou column se trouve 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 l'column.

Voir aussi setColumnMinimumWidth().

int QGridLayout::columnStretch(int column) const

Renvoie le facteur d'étirement de 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 de position de l'élément dont l'index est spécifiée.

Les variables passées sous forme d’ row et d’ column sont mises à jour avec la position de l’élément dans la mise en page, tandis que les variables rowSpan et columnSpan sont mises à jour avec les largeurs verticale et horizontale de l’élément.

Voir également 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 également 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é comme origine de la grille, c'est-à-dire pour la position (0, 0).

Voir également 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 aussi setRowMinimumHeight().

int QGridLayout::rowStretch(int row) const

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

Voir aussi setRowStretch().

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

Définit la largeur minimale de la colonne column à minSize pixels.

Voir également columnMinimumWidth() et setRowMinimumHeight().

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

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

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

Le facteur d'étirement par défaut est 0. Si le facteur d'étirement est égal à 0 et qu'aucune autre colonne de ce tableau ne peut s'étendre, cette colonne peut tout de même s'étendre.

Une autre approche consiste à ajouter un espacement à l'aide de la fonction addItem() avec un 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)

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

Voir également originCorner().

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

Définit la hauteur minimale de la ligne row à minSize pixels.

Voir également rowMinimumHeight() et setColumnMinimumWidth().

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

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

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

Le facteur d'étirement par défaut est 0. Si le facteur d'étirement est 0 et qu'aucune autre ligne de ce tableau ne peut s'étendre, cette ligne peut tout de même s'étendre.

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

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

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

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