The QVBoxLayout class lines up widgets vertically. More...
|CMake:|| find_package(Qt6 REQUIRED COMPONENTS Widgets) |
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
|qmake:||QT += widgets|
This class is used to construct vertical box layout objects. See QBoxLayout for details.
The simplest use of the class is like this:
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();
First, we create the widgets we want to add to the layout. Then, we create the QVBoxLayout object, setting
window as parent by passing it in the constructor; next we add the widgets to the layout.
window will be the parent of the widgets that are added to the layout.
If you don't pass a parent
window to the constructor, you can at a later point use QWidget::setLayout() to install the QVBoxLayout object onto
window. At that point, the widgets in the layout are reparented to have
window as their parent.
See also QHBoxLayout, QGridLayout, QStackedLayout, Layout Management, and Basic Layouts Example.
Member Function Documentation
Constructs a new vertical box. You must add it to another layout.
[explicit] QVBoxLayout::QVBoxLayout(QWidget *parent)
Constructs a new top-level vertical box with parent parent.
The layout is set directly as the top-level layout for parent. There can be only one top-level layout for a widget. It is returned by QWidget::layout().
See also QWidget::setLayout().
[virtual noexcept] QVBoxLayout::~QVBoxLayout()
Destroys this box layout.
The layout's widgets aren't destroyed.
© 2023 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.