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