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

#include <qboxlayout.h>

Inheritance diagram for QHBoxLayout:

Collaboration diagram for QHBoxLayout:

Public Member Functions
	QHBoxLayout ()

	QHBoxLayout (QWidget *parent)

	~QHBoxLayout ()

Public Member Functions inherited from QBoxLayout
	QBoxLayout (Direction, QWidget *parent=nullptr)

	~QBoxLayout ()

Direction	direction () const

void	setDirection (Direction)

void	addSpacing (int size)

void	addStretch (int stretch=0)

void	addSpacerItem (QSpacerItem *spacerItem)

void	addWidget (QWidget *, int stretch=0, Qt::Alignment alignment=Qt::Alignment())

void	addLayout (QLayout *layout, int stretch=0)

void	addStrut (int)

void	addItem (QLayoutItem *) override

void	insertSpacing (int index, int size)

void	insertStretch (int index, int stretch=0)

void	insertSpacerItem (int index, QSpacerItem *spacerItem)

void	insertWidget (int index, QWidget *widget, int stretch=0, Qt::Alignment alignment=Qt::Alignment())

void	insertLayout (int index, QLayout *layout, int stretch=0)

void	insertItem (int index, QLayoutItem *)

int	spacing () const override

void	setSpacing (int spacing) override

bool	setStretchFactor (QWidget *w, int stretch)

bool	setStretchFactor (QLayout *l, int stretch)

void	setStretch (int index, int stretch)

int	stretch (int index) const

QSize	sizeHint () const override

QSize	minimumSize () const override

QSize	maximumSize () const override

bool	hasHeightForWidth () const override

int	heightForWidth (int) const override

int	minimumHeightForWidth (int) const override

Qt::Orientations	expandingDirections () const override

void	invalidate () override

QLayoutItem *	itemAt (int) const override

QLayoutItem *	takeAt (int) override

int	count () const override

void	setGeometry (const QRect &) override

Public Member Functions inherited from QLayout
	QLayout (QWidget *parent=nullptr)

	~QLayout ()

void	setContentsMargins (int left, int top, int right, int bottom)

void	setContentsMargins (const QMargins &margins)

void	unsetContentsMargins ()

void	getContentsMargins (int left, int top, int right, int bottom) const

QMargins	contentsMargins () const

QRect	contentsRect () const

bool	setAlignment (QWidget *w, Qt::Alignment alignment)

bool	setAlignment (QLayout *l, Qt::Alignment alignment)

void	setSizeConstraint (SizeConstraint)

SizeConstraint	sizeConstraint () const

void	setMenuBar (QWidget *w)

QWidget *	menuBar () const

QWidget *	parentWidget () const

void	invalidate () override

QRect	geometry () const override

bool	activate ()

void	update ()

void	addWidget (QWidget *w)

void	removeWidget (QWidget *w)

void	removeItem (QLayoutItem *)

Qt::Orientations	expandingDirections () const override

QSize	minimumSize () const override

QSize	maximumSize () const override

virtual int	indexOf (const QWidget *) const

virtual int	indexOf (const QLayoutItem *) const

bool	isEmpty () const override

QSizePolicy::ControlTypes	controlTypes () const override

virtual QLayoutItem *	replaceWidget (QWidget from, QWidget to, Qt::FindChildOptions options=Qt::FindChildrenRecursively)

int	totalMinimumHeightForWidth (int w) const

int	totalHeightForWidth (int w) const

QSize	totalMinimumSize () const

QSize	totalMaximumSize () const

QSize	totalSizeHint () const

QLayout *	layout () override

void	setEnabled (bool)

bool	isEnabled () const

void	setAlignment (Qt::Alignment a)

Public Member Functions inherited from QObject
Q_INVOKABLE	QObject (QObject *parent=nullptr)

virtual	~QObject ()

virtual bool	event (QEvent *event)

virtual bool	eventFilter (QObject watched, QEvent event)

QString	objectName () const

void	setObjectName (const QString &name)

QBindable< QString >	bindableObjectName ()

bool	isWidgetType () const

bool	isWindowType () const

bool	signalsBlocked () const noexcept

bool	blockSignals (bool b) noexcept

QThread *	thread () const

void	moveToThread (QThread *thread)

int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)

void	killTimer (int id)

template<typename T >
T	findChild (const QString &aName=QString(), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<typename T >
QList< T >	findChildren (const QString &aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<typename T >
QList< T >	findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

const QObjectList &	children () const

void	setParent (QObject *parent)

void	installEventFilter (QObject *filterObj)

void	removeEventFilter (QObject *obj)

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const

bool	disconnect (const char signal=nullptr, const QObject receiver=nullptr, const char *member=nullptr) const

bool	disconnect (const QObject receiver, const char member=nullptr) const

void	dumpObjectTree () const

void	dumpObjectInfo () const

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const

QList< QByteArray >	dynamicPropertyNames () const

QBindingStorage *	bindingStorage ()

const QBindingStorage *	bindingStorage () const

QObject *	parent () const

bool	inherits (const char *classname) const

Public Member Functions inherited from QLayoutItem
	QLayoutItem (Qt::Alignment alignment=Qt::Alignment())

virtual	~QLayoutItem ()

virtual QWidget *	widget () const

virtual QSpacerItem *	spacerItem ()

Qt::Alignment	alignment () const

void	setAlignment (Qt::Alignment a)

Additional Inherited Members
Public Types inherited from QBoxLayout
enum	Direction { LeftToRight , RightToLeft , TopToBottom , BottomToTop , Down = TopToBottom , Up = BottomToTop }

Public Types inherited from QLayout
enum	SizeConstraint { SetDefaultConstraint , SetNoConstraint , SetMinimumSize , SetFixedSize , SetMaximumSize , SetMinAndMaxSize }

Public Slots inherited from QObject
void	deleteLater ()

Signals inherited from QObject
void	destroyed (QObject *=nullptr)

void	objectNameChanged (const QString &objectName, QPrivateSignal)

Static Public Member Functions inherited from QLayout
static QSize	closestAcceptableSize (const QWidget *w, const QSize &s)

Static Public Member Functions inherited from QObject
static QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char member, Qt::ConnectionType=Qt::AutoConnection)

static QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)

template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiver, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

static QMetaObject::Connection ::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)

static QMetaObject::Connection ::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)

template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

static bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char member)

static bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &member)

static bool	disconnect (const QMetaObject::Connection &)

template<typename Func1 , typename Func2 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiver, Func2 slot)

template<typename Func1 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject receiver, void **zero)

Protected Member Functions inherited from QLayout
void	widgetEvent (QEvent *)

void	childEvent (QChildEvent *e) override

void	addChildLayout (QLayout *l)

void	addChildWidget (QWidget *w)

bool	adoptLayout (QLayout *layout)

QRect	alignmentRect (const QRect &) const

	QLayout (QLayoutPrivate &d, QLayout , QWidget )

Protected Member Functions inherited from QObject
QObject *	sender () const

int	senderSignalIndex () const

int	receivers (const char *signal) const

bool	isSignalConnected (const QMetaMethod &signal) const

virtual void	timerEvent (QTimerEvent *event)

virtual void	customEvent (QEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	disconnectNotify (const QMetaMethod &signal)

	QObject (QObjectPrivate &dd, QObject *parent=nullptr)

Protected Attributes inherited from QObject
QScopedPointer< QObjectData >	d_ptr

Protected Attributes inherited from QLayoutItem
Qt::Alignment	align

Properties inherited from QLayout
int	spacing
	the spacing between widgets inside the layout More...

QMargins	contentsMargins

SizeConstraint	sizeConstraint
	the resize mode of the layout More...

Properties inherited from QObject
QString	objectName
	the name of this object More...

Related Functions inherited from QObject
template< class T > T	qobject_cast (const QObject *object)

template< typename T > T	qFindChildqFindChildren (const QObject *obj, const QString &name)()

template< typename T > QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()

	QObjectList

Detailed Description

The QHBoxLayout class lines up widgets horizontally.

\inmodule QtWidgets

This class is used to construct horizontal box layout objects. See QBoxLayout for details.

The simplest use of the class is like this:

\codeline

First, we create the widgets we want to add to the layout. Then, we create the QHBoxLayout 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 QHBoxLayout object onto window. 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}, {Basic Layouts Example}

Definition at line 113 of file qboxlayout.h.

Constructor & Destructor Documentation

◆ QHBoxLayout() [1/2]

QHBoxLayout::QHBoxLayout ( )

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

Definition at line 1273 of file qboxlayout.cpp.

◆ QHBoxLayout() [2/2]

QHBoxLayout::QHBoxLayout ( QWidget * parent )

explicit

Constructs a new top-level horizontal 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()

Definition at line 1264 of file qboxlayout.cpp.

◆ ~QHBoxLayout()

QHBoxLayout::~QHBoxLayout ( )

Destroys this box layout.

The layout's widgets aren't destroyed.

Definition at line 1287 of file qboxlayout.cpp.

The documentation for this class was generated from the following files:

src/widgets/kernel/qboxlayout.h
src/widgets/kernel/qboxlayout.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QHBoxLayout() [1/2]

◆ QHBoxLayout() [2/2]

◆ ~QHBoxLayout()