QHBoxLayout Class

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

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

Public Functions

QHBoxLayout(QWidget *parent)
virtual ~QHBoxLayout()
  • 33 public functions inherited from QBoxLayout
  • 36 public functions inherited from QLayout
  • 33 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 public variable inherited from QObject
  • 1 static public member inherited from QLayout
  • 10 static public members inherited from QObject
  • 4 protected functions inherited from QLayout
  • 9 protected functions inherited from QObject
  • 2 protected variables 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;


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

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

Member Function Documentation


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.

[virtual] QHBoxLayout::~QHBoxLayout()

Destroys this box layout.

The layout's widgets aren't destroyed.

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
create apps
create games
cross platform
native performance
3rd party services
game network
level editor
easiest to learn
biggest time saving
best support