Sur cette page

QVBoxLayout Class

La classe QVBoxLayout aligne les widgets verticalement. Plus d'informations...

En-tête : #include <QVBoxLayout>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : QBoxLayout

Fonctions publiques

QVBoxLayout()
QVBoxLayout(QWidget *parent)
virtual ~QVBoxLayout()

Description détaillée

Cette classe est utilisée pour construire des objets de disposition de boîtes verticales. Voir QBoxLayout pour plus de détails.

L'utilisation la plus simple de la classe est la suivante :

QWidget *window = new QWidget;
QPushButton *button1 = new QPushButton("One");
QPushButton *button2 = new QPushButton("Two");
QPushButton *button3 = new QPushButton("Three");
QPushButton *button4 = new QPushButton("Four");
QPushButton *button5 = new QPushButton("Five");

QVBoxLayout *layout = new QVBoxLayout(window);
layout->addWidget(button1);
layout->addWidget(button2);
layout->addWidget(button3);
layout->addWidget(button4);
layout->addWidget(button5);

window->show();

Tout d'abord, nous créons les widgets que nous voulons ajouter à la disposition. Ensuite, nous créons l'objet QVBoxLayout, en définissant window comme parent en le passant dans le constructeur ; puis nous ajoutons les widgets à la disposition. window sera le parent des widgets qui sont ajoutés à la disposition.

Si vous ne passez pas de parent à window dans le constructeur, vous pouvez ultérieurement utiliser QWidget::setLayout() pour installer l'objet QVBoxLayout sur window. À ce moment-là, les widgets de la disposition sont reparentés pour avoir window comme parent.

Disposition en boîte horizontale avec cinq widgets enfants

Voir également QHBoxLayout, QGridLayout, QStackedLayout, Gestion des dispositions et Exemple de dispositions de base.

Documentation des fonctions membres

QVBoxLayout::QVBoxLayout()

Construit une nouvelle boîte verticale. Vous devez l'ajouter à une autre mise en page.

[explicit] QVBoxLayout::QVBoxLayout(QWidget *parent)

Construit une nouvelle boîte verticale de premier niveau avec le parent parent.

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

Voir aussi QWidget::setLayout().

[virtual noexcept] QVBoxLayout::~QVBoxLayout()

Détruit cette boîte de présentation.

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.