QBoxLayout Class

Documentation sur les fonctions membres

[explicit] QBoxLayout::QBoxLayout(QBoxLayout::Direction dir, QWidget *parent = nullptr)

Crée un nouveau QBoxLayout avec la direction dir et le widget parent parent.

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 QWidget::layout().

Voir également direction() et QWidget::setLayout().

[virtual noexcept] QBoxLayout::~QBoxLayout()

Supprime cette mise en page de la boîte.

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

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

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

void QBoxLayout::addLayout(QLayout *layout, int stretch = 0)

Ajoute « layout » à la fin de la boîte, avec un facteur d'étirement en série de stretch.

layout Devient un élément enfant de la mise en page de la boîte.

Voir également insertLayout(), addItem() et addWidget().

void QBoxLayout::addSpacerItem(QSpacerItem *spacerItem)

Ajoute spacerItem à la fin de cette mise en page de boîte.

La propriété de spacerItem est transférée à cette mise en page.

Voir également addSpacing() et addStretch().

void QBoxLayout::addSpacing(int size)

Ajoute un espace non extensible (un « QSpacerItem ») de taille size à la fin de cette mise en page de boîte. QBoxLayout fournit les marges et espacements par défaut. Cette fonction ajoute un espace supplémentaire.

Voir également insertSpacing(), addItem() et QSpacerItem.

void QBoxLayout::addStretch(int stretch = 0)

Ajoute un espace extensible (un « QSpacerItem ») de taille minimale nulle et de facteur d'extension stretch à la fin de cette mise en page de boîte.

Voir également insertStretch(), addItem() et QSpacerItem.

void QBoxLayout::addStrut(int size)

Limite la dimension perpendiculaire de la boîte (par exemple, la hauteur si la boîte est de type « LeftToRight ») à une valeur minimale de size. D'autres contraintes peuvent augmenter cette limite.

Voir également addItem().

void QBoxLayout::addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

Ajoute widget à la fin de cette mise en page de boîte, avec un facteur d'étirement de stretch et un alignement de alignment.

Le facteur d'étirement s'applique uniquement au sein de l'direction de l'QBoxLayout, et est relatif aux autres boîtes et widgets de ce QBoxLayout. Les widgets et les boîtes ayant des facteurs d'étirement plus élevés s'agrandissent davantage.

Si le facteur d'étirement est égal à 0 et qu'aucun autre élément de l'QBoxLayout ne possède un facteur d'étirement supérieur à zéro, l'espace est réparti en fonction de la QWidget::sizePolicy() de chaque widget concerné.

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

widget devient un enfant de l’ QLayout::parentWidget().

Voir également insertWidget(), addItem(), addLayout(), addStretch(), addSpacing() et addStrut().

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

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

QBoxLayout::Direction QBoxLayout::direction() const

Renvoie la direction de la boîte. Les fonctions ` addWidget()` et ` addSpacing()` agissent dans cette direction ; l'étirement s'effectue dans cette direction.

Voir également setDirection(), QBoxLayout::Direction, addWidget() et addSpacing().

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

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

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

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

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

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

void QBoxLayout::insertItem(int index, QLayoutItem *item)

Insère item dans cette mise en page de boîte à la position index. L'index doit être soit négatif, soit compris entre 0 et count(), inclus. Si index est négatif ou égal à count(), l'élément est ajouté à la fin.

La propriété de item est transmise à cette mise en page.

Voir également addItem(), insertWidget(), insertLayout(), insertStretch() et insertSpacing().

void QBoxLayout::insertLayout(int index, QLayout *layout, int stretch = 0)

Insère layout à la position index, avec un facteur d'étirement de stretch. Si index est négatif, la mise en page est ajoutée à la fin.

layout devient un enfant de la mise en page de la boîte.

Voir également addLayout() et insertItem().

void QBoxLayout::insertSpacerItem(int index, QSpacerItem *spacerItem)

Insère spacerItem à la position index, avec une taille minimale et un facteur d'étirement égaux à zéro. Si index est négatif, l'espace est ajouté à la fin.

La propriété de spacerItem est transmise à cette mise en page.

Voir également addSpacerItem(), insertStretch() et insertSpacing().

void QBoxLayout::insertSpacing(int index, int size)

Insère un espace non extensible ( QSpacerItem) à la position index, avec une taille de size. Si index est négatif, l'espace est ajouté à la fin.

La mise en page de la boîte comporte des marges et un espacement par défaut. Cette fonction ajoute un espace supplémentaire.

Voir également addSpacing(), insertItem() et QSpacerItem.

void QBoxLayout::insertStretch(int index, int stretch = 0)

Insère un espace extensible (un QSpacerItem) à la position index, avec une taille minimale nulle et un facteur d'étirement stretch. Si index est négatif, l'espace est ajouté à la fin.

Voir également addStretch(), insertItem() et QSpacerItem.

void QBoxLayout::insertWidget(int index, QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

Insère widget à la position index, avec un facteur d'étirement stretch et un alignement alignment. Si index est négatif, le widget est ajouté à la fin.

Le facteur d’étirement s’applique uniquement au sein de l’ direction de l’ QBoxLayout et est relatif aux autres boîtes et widgets de cette QBoxLayout. Les widgets et les boîtes présentant des facteurs d’étirement plus élevés s’étendent davantage.

Si le facteur d’étirement est égal à 0 et qu’aucun autre élément de l’ QBoxLayout ne présente un facteur d’étirement supérieur à zéro, l’espace est réparti en fonction de la QWidget::sizePolicy() de chaque widget concerné.

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

widget devient un enfant de l’ QLayout::parentWidget().

Voir également addWidget() et insertItem().

[override virtual] void QBoxLayout::invalidate()

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

Réinitialise les informations mises en cache.

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

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

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

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

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

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

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

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

void QBoxLayout::setDirection(QBoxLayout::Direction direction)

Définit l'orientation de cette mise en page sur « direction ».

Voir également direction().

[override virtual] void QBoxLayout::setGeometry(const QRect &r)

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

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

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

Réimplémente la méthode QLayout::setSpacing(). Définit la propriété d'espacement sur spacing.

Voir également QLayout::setSpacing() et spacing().

void QBoxLayout::setStretch(int index, int stretch)

Définit le facteur d'étirement à la position index sur stretch.

Voir également stretch().

bool QBoxLayout::setStretchFactor(QWidget *widget, int stretch)

Définit le facteur d'étirement de widget sur stretch et renvoie « true » si widget est présent dans cette mise en page (à l'exclusion des mises en page enfants) ; sinon, renvoie « false ».

Voir également setAlignment().

bool QBoxLayout::setStretchFactor(QLayout *layout, int stretch)

Définit le facteur d'étirement de la mise en page layout sur stretch et renvoie true si layout est détecté dans cette mise en page (à l'exclusion des mises en page enfants) ; sinon, renvoie false.

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

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

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

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

Réimplémente la méthode QLayout::spacing(). Si la propriété spacing est valide, cette valeur est renvoyée. Sinon, une valeur pour la propriété spacing est calculée et renvoyée. Étant donné que l'espacement de la mise en page dans un widget dépend du style, si le parent est un widget, il interroge le style pour obtenir l'espacement (horizontal ou vertical) de la mise en page. Sinon, le parent est une mise en page, et il interroge la mise en page parente pour obtenir la valeur de spacing().

Voir également QLayout::spacing() et setSpacing().

int QBoxLayout::stretch(int index) const

Renvoie le facteur d'étirement à la position index.

Voir également setStretch().

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

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