QSpacerItem Class Reference

The QSpacerItem class provides blank space in a layout. More...

#include <qlayoutitem.h>

Inheritance diagram for QSpacerItem:

Collaboration diagram for QSpacerItem:

Public Member Functions
	QSpacerItem (int w, int h, QSizePolicy::Policy hData=QSizePolicy::Minimum, QSizePolicy::Policy vData=QSizePolicy::Minimum)
	~QSpacerItem ()
void	changeSize (int w, int h, QSizePolicy::Policy hData=QSizePolicy::Minimum, QSizePolicy::Policy vData=QSizePolicy::Minimum)
QSize	sizeHint () const override
QSize	minimumSize () const override
QSize	maximumSize () const override
Qt::Orientations	expandingDirections () const override
bool	isEmpty () const override
void	setGeometry (const QRect &) override
QRect	geometry () const override
QSpacerItem *	spacerItem () override
QSizePolicy	sizePolicy () const
Public Member Functions inherited from QLayoutItem
	QLayoutItem (Qt::Alignment alignment=Qt::Alignment())
virtual	~QLayoutItem ()
virtual bool	hasHeightForWidth () const
virtual int	heightForWidth (int) const
virtual int	minimumHeightForWidth (int) const
virtual void	invalidate ()
virtual QWidget *	widget () const
virtual QLayout *	layout ()
Qt::Alignment	alignment () const
void	setAlignment (Qt::Alignment a)
virtual QSizePolicy::ControlTypes	controlTypes () const

Additional Inherited Members
Protected Attributes inherited from QLayoutItem
Qt::Alignment	align

Detailed Description

The QSpacerItem class provides blank space in a layout.

\inmodule QtWidgets

Normally, you don't need to use this class directly. Qt's built-in layout managers provide the following functions for manipulating empty space in layouts:

\table \header

• Class
• Functions \row
• QHBoxLayout
• \l{QBoxLayout::addSpacing()}{addSpacing()}, \l{QBoxLayout::addStretch()}{addStretch()}, \l{QBoxLayout::insertSpacing()}{insertSpacing()}, \l{QBoxLayout::insertStretch()}{insertStretch()} \row
• QGridLayout
• \l{QGridLayout::setRowMinimumHeight()}{setRowMinimumHeight()}, \l{QGridLayout::setRowStretch()}{setRowStretch()}, \l{QGridLayout::setColumnMinimumWidth()}{setColumnMinimumWidth()}, \l{QGridLayout::setColumnStretch()}{setColumnStretch()} \endtable

See also

QLayout, QWidgetItem, QLayoutItem::spacerItem()

Definition at line 92 of file qlayoutitem.h.

Constructor & Destructor Documentation

QSpacerItem()

QSpacerItem::QSpacerItem ( int  w, int  h, QSizePolicy::Policy  hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy  vPolicy = QSizePolicy::Minimum  )

inline

Constructs a spacer item with preferred width w, preferred height h, horizontal size policy hPolicy and vertical size policy vPolicy.

The default values provide a gap that is able to stretch if nothing else wants the space.

Definition at line 95 of file qlayoutitem.h.

~QSpacerItem()

QSpacerItem::~QSpacerItem

(

)

Destructor.

Definition at line 261 of file qlayoutitem.cpp.

Member Function Documentation

changeSize()

void QSpacerItem::changeSize	(	int	w,
		int	h,
		QSizePolicy::Policy	hPolicy = QSizePolicy::Minimum,
		QSizePolicy::Policy	vPolicy = QSizePolicy::Minimum
	)

Changes this spacer item to have preferred width w, preferred height h, horizontal size policy hPolicy and vertical size policy vPolicy.

The default values provide a gap that is able to stretch if nothing else wants the space.

Note that if changeSize() is called after the spacer item has been added to a layout, it is necessary to invalidate the layout in order for the spacer item's new size to take effect.

See also

QSpacerItem::invalidate()

Definition at line 277 of file qlayoutitem.cpp.

Here is the caller graph for this function:

expandingDirections()

Qt::Orientations QSpacerItem::expandingDirections ( ) const

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 611 of file qlayoutitem.cpp.

Here is the call graph for this function:

geometry()

QRect QSpacerItem::geometry ( ) const

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 520 of file qlayoutitem.cpp.

isEmpty()

bool QSpacerItem::isEmpty ( ) const

overridevirtual

Returns true.

Implements QLayoutItem.

Definition at line 722 of file qlayoutitem.cpp.

maximumSize()

QSize QSpacerItem::maximumSize ( ) const

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 669 of file qlayoutitem.cpp.

Here is the call graph for this function:

minimumSize()

QSize QSpacerItem::minimumSize ( ) const

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 648 of file qlayoutitem.cpp.

Here is the call graph for this function:

setGeometry()

void QSpacerItem::setGeometry ( const QRect &  r )

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 441 of file qlayoutitem.cpp.

sizeHint()

QSize QSpacerItem::sizeHint ( ) const

overridevirtual

\reimp

Implements QLayoutItem.

Definition at line 692 of file qlayoutitem.cpp.

sizePolicy()

QSizePolicy QSpacerItem::sizePolicy ( ) const

inline

Since

5.5

Returns the size policy of this item.

Definition at line 112 of file qlayoutitem.h.

spacerItem()

QSpacerItem * QSpacerItem::spacerItem ( )

overridevirtual

Returns a pointer to this object.

Reimplemented from QLayoutItem.

Definition at line 341 of file qlayoutitem.cpp.

---

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

• src/widgets/kernel/qlayoutitem.h
• src/widgets/kernel/qlayoutitem.cpp