QVBoxLayout Class | Qt Widgets 5.12.12

- Qt 5.12
- Qt Widgets
- C++ Classes
- QVBoxLayout
- Qt 5.12.12 Reference Documentation

# QVBoxLayout Class

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

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

- List of all members, including inherited members
- Obsolete members

## Public Functions

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

- 33 public functions inherited from QBoxLayout
- 37 public functions inherited from QLayout
- 31 public functions inherited from QObject
- 17 public functions inherited from QLayoutItem

## Static Public Members

const QMetaObject | staticMetaObject

- 1 static public member inherited from QLayout
- 9 static public members inherited from QObject

### Additional Inherited Members

- 2 properties inherited from QLayout
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 2 signals inherited from QObject
- 4 protected functions inherited from QLayout
- 9 protected functions inherited from QObject

## Detailed Description

The QVBoxLayout class lines up widgets vertically.

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 parent `window` in the constrcutor, 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()

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

### 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]` QVBoxLayout::~QVBoxLayout()

Destroys this box layout.

The layout's widgets aren't destroyed.