本页内容

QSpacerItem Class

QSpacerItem 类用于在布局中提供空白区域。更多内容...

标题: #include <QSpacerItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
继承自: QLayoutItem

公共函数

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

重新实现的公共函数

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

详细描述

通常情况下,您无需直接使用此类。Qt 的内置布局管理器提供了以下函数,用于处理布局中的空白区域:

另请参阅 QLayout 、QWidgetItem 以及QLayoutItem::spacerItem()。

成员函数文档

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

创建一个间隔项,其首选宽度为w ,首选高度为h ,水平尺寸策略为hPolicy ,垂直尺寸策略为vPolicy 。

如果没有其他元素需要该空间,默认值会提供一个可拉伸的间隙。

[virtual noexcept] QSpacerItem::~QSpacerItem()

析构函数。

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

将此间隔元素的首选宽度设置为w ,首选高度设置为h ,水平尺寸策略设置为hPolicy ,垂直尺寸策略设置为vPolicy 。

默认值会提供一个间隙,如果其他元素都不需要该空间,该间隙可以进行拉伸。

请注意,如果在间隔项已添加到布局之后调用 changeSize(),则必须使布局失效,才能使间隔项的新尺寸生效。

另请参阅 QSpacerItem::invalidate()。

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

重新实现了:QLayoutItem::expandingDirections() const。

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

重新实现了:QLayoutItem::geometry() const。

另请参阅 setGeometry()。

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

重新实现了:QLayoutItem::isEmpty() const。

返回true 。

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

重新实现了:QLayoutItem::maximumSize() const。

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

重新实现了:QLayoutItem::minimumSize() const。

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

重写了:QLayoutItem::setGeometry(const QRect &r)。

另请参阅 geometry()。

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

重新实现了:QLayoutItem::sizeHint() const。

QSizePolicy QSpacerItem::sizePolicy() const

返回该项目的大小策略。

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

重写了:QLayoutItem::spacerItem()。

返回指向此对象的指针。

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