QVBoxLayout Class | Qt Widgets 6.2.4

- Qt 6.2
- Qt Widgets
- C++ Classes
- QVBoxLayout
- Qt 6.2.4 Reference Documentation

# QVBoxLayout Class

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

Header: | #include <QVBoxLayout>
CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: | QT += widgets
Inherits: | QBoxLayout

- List of all members, including inherited members

## Public Functions

| QVBoxLayout(QWidget *parent)
| QVBoxLayout()
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(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

### 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().

### QVBoxLayout::QVBoxLayout()

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.