このページでは

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.