QVBoxLayout Class

The QVBoxLayout class lines up widgets vertically. More...

Header: #include <QVBoxLayout>
qmake: QT += widgets
Inherits: QBoxLayout

Public Functions

QVBoxLayout(QWidget *parent)
virtual ~QVBoxLayout()

Detailed Description

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;


First, we create the widgets we want in the layout. Then, we create the QVBoxLayout object and add the widgets into the layout. Finally, we call QWidget::setLayout() to install the QVBoxLayout object onto the widget. At that point, the widgets in the layout are reparented to have window as their parent.

Horizontal box layout with five child widgets

See also QHBoxLayout, QGridLayout, QStackedLayout, Layout Management, and Basic Layouts Example.

Member Function Documentation

QVBoxLayout::QVBoxLayout(QWidget *parent)

Constructs a new top-level vertical box with parent parent.


Constructs a new vertical box. You must add it to another layout.

[virtual] QVBoxLayout::~QVBoxLayout()

Destroys this box layout.

The layout's widgets aren't destroyed.

© 2020 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.