이 페이지에서

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.