QSpacerItem Class

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

Header: #include <QSpacerItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QLayoutItem

Public Functions

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

Reimplemented Public Functions

virtual Qt::Orientations expandingDirections() const override
virtual QRect geometry() const override
virtual bool isEmpty() const override
virtual QSize maximumSize() const override
virtual QSize minimumSize() const override
virtual void setGeometry(const QRect &r) override
virtual QSize sizeHint() const override
virtual QSpacerItem *spacerItem() override

Detailed Description

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:

See also QLayout, QWidgetItem, and QLayoutItem::spacerItem().

Member Function Documentation

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

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.

[virtual noexcept] QSpacerItem::~QSpacerItem()

Destructor.

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().

[override virtual] Qt::Orientations QSpacerItem::expandingDirections() const

Reimplements: QLayoutItem::expandingDirections() const.

[override virtual] QRect QSpacerItem::geometry() const

Reimplements: QLayoutItem::geometry() const.

See also setGeometry().

[override virtual] bool QSpacerItem::isEmpty() const

Reimplements: QLayoutItem::isEmpty() const.

Returns true.

[override virtual] QSize QSpacerItem::maximumSize() const

Reimplements: QLayoutItem::maximumSize() const.

[override virtual] QSize QSpacerItem::minimumSize() const

Reimplements: QLayoutItem::minimumSize() const.

[override virtual] void QSpacerItem::setGeometry(const QRect &r)

Reimplements: QLayoutItem::setGeometry(const QRect &r).

See also geometry().

[override virtual] QSize QSpacerItem::sizeHint() const

Reimplements: QLayoutItem::sizeHint() const.

QSizePolicy QSpacerItem::sizePolicy() const

Returns the size policy of this item.

[override virtual] QSpacerItem *QSpacerItem::spacerItem()

Reimplements: QLayoutItem::spacerItem().

Returns a pointer to this object.

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