Qt Documentation

QHBoxLayout Class

The QHBoxLayout class lines up widgets horizontally. More...

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

List of all members, including inherited members

Public Functions

	QHBoxLayout()
	QHBoxLayout(QWidget *parent)
	~QHBoxLayout()

33 public functions inherited from QBoxLayout
36 public functions inherited from QLayout
31 public functions inherited from QObject
17 public functions inherited from QLayoutItem

Additional Inherited Members

2 properties inherited from QLayout
1 property inherited from QObject
1 public slot inherited from QObject
2 signals inherited from QObject
1 static public member inherited from QLayout
11 static public members inherited from QObject
4 protected functions inherited from QLayout
9 protected functions inherited from QObject

Detailed Description

The QHBoxLayout class lines up widgets horizontally.

This class is used to construct horizontal 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");

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

    window->setLayout(layout);
    window->show();

First, we create the widgets we want in the layout. Then, we create the QHBoxLayout object and add the widgets into the layout. Finally, we call QWidget::setLayout() to install the QHBoxLayout 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

Member Function Documentation

QHBoxLayout::QHBoxLayout()

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

QHBoxLayout::QHBoxLayout(QWidget **parent*)

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

QHBoxLayout::~QHBoxLayout()

Destroys this box layout.

The layout's widgets aren't destroyed.

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