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:
| Class | Functions |
|---|---|
| QHBoxLayout | addSpacing(), addStretch(), insertSpacing(), insertStretch() |
| QGridLayout | setRowMinimumHeight(), setRowStretch(), setColumnMinimumWidth(), setColumnStretch() |
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.