이 페이지에서

QSizeGrip Class

QSizeGrip 클래스는 최상위 창의 크기를 조정할 수 있는 크기 조정 핸들을 제공합니다. 더 보기...

헤더: #include <QSizeGrip>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속: QWidget

공개 함수

QSizeGrip(QWidget *parent)
virtual ~QSizeGrip()

재구현된 공용 함수

virtual void setVisible(bool visible) override
virtual QSize sizeHint() const override

재구현된 보호 함수

virtual bool event(QEvent *event) override
virtual bool eventFilter(QObject *o, QEvent *e) override
virtual void hideEvent(QHideEvent *hideEvent) override
virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *mouseEvent) override
virtual void moveEvent(QMoveEvent *moveEvent) override
virtual void paintEvent(QPaintEvent *event) override
virtual void showEvent(QShowEvent *showEvent) override

상세 설명

이 위젯은 표준 Windows 크기 조정 핸들과 유사하게 작동합니다. X11 버전에서 이 크기 조정 핸들은 X11 창 관리자가 필요한 최신 ICCCM 이후 사양을 지원하지 않는 경우, 일반적으로 시스템에서 제공하는 핸들과 다르게 작동합니다.

이 위젯을 위젯 트리의 아무 곳에나 배치하면, 사용자는 이를 통해 최상위 창이나 Qt::SubWindow 플래그가 설정된 모든 위젯의 크기를 조정할 수 있습니다. 일반적으로 이 위젯은 오른쪽 하단 모서리에 배치해야 합니다.

QStatusBar 는 이미 이 위젯을 사용하고 있으므로, 상태 표시줄(예: QMainWindow 사용 중)이 있다면 이 위젯을 명시적으로 사용할 필요가 없습니다. QDialog 의 경우도 마찬가지이며, 이 경우 QDialog::setSizeGripEnabled()를 호출하기만 하면 됩니다.

일부 플랫폼에서는 창이 전체 화면으로 표시되거나 최대화되면 크기 조정 손잡이가 자동으로 숨겨집니다.

참고: macOS에서는 크기 조절 손잡이가 더 이상 사용자 인터페이스 지침(Human Interface Guidelines)의 일부가 아니며, ` QMdiSubWindow`에서 사용되지 않는 한 표시되지 않습니다. 메인 창에서 표시되도록 하려는 크기 조절 손잡이에는 다른 스타일을 지정하십시오.

오른쪽 하단 모서리의 크기 조절 버튼

Fusion 위젯 스타일로 표시된 메인 창의 오른쪽 하단 모서리에 있는 크기 조정 손잡이 위젯.

QSizeGrip 클래스는 QWidget 을 상속받으며, 크기 조정 기능을 구현하기 위해 mousePressEvent() 및 mouseMoveEvent() 함수를 재구현하고, 크기 조정 손잡이 위젯을 렌더링하기 위해 paintEvent() 함수를 재구현합니다.

QStatusBar 및 QWidget::windowState()도 참조하십시오 .

멤버 함수 문서

[explicit] QSizeGrip::QSizeGrip(QWidget *parent)

지정된 ` parent`의 자식 위젯으로 크기 조정 모서리를 생성합니다.

[virtual noexcept] QSizeGrip::~QSizeGrip()

이 크기의 그립을 파괴합니다.

[override virtual protected] bool QSizeGrip::event(QEvent *event)

QWidget::event(QEvent *event)를 재구현합니다.

[override virtual protected] bool QSizeGrip::eventFilter(QObject *o, QEvent *e)

QObject::eventFilter(QObject *watched, QEvent *event)을 재구현합니다.

[override virtual protected] void QSizeGrip::hideEvent(QHideEvent *hideEvent)

QWidget::hideEvent(QHideEvent *event)를 재구현합니다.

[override virtual protected] void QSizeGrip::mouseMoveEvent(QMouseEvent *event)

QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

이 위젯을 포함하는 최상위 위젯의 크기를 조정합니다. 마우스 이동 이벤트는 event 매개변수를 통해 전달됩니다.

[override virtual protected] void QSizeGrip::mousePressEvent(QMouseEvent *event)

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

위젯에 대한 마우스 클릭 이벤트를 수신하고, 크기 조정 작업을 준비합니다. 마우스 클릭 이벤트는 event 매개변수를 통해 전달됩니다.

[override virtual protected] void QSizeGrip::mouseReleaseEvent(QMouseEvent *mouseEvent)

QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QSizeGrip::moveEvent(QMoveEvent *moveEvent)

QWidget::moveEvent(QMoveEvent *event)를 재구현합니다.

[override virtual protected] void QSizeGrip::paintEvent(QPaintEvent *event)

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

크기 조정 핸들을 그립니다.

크기 조정 핸들은 일반적으로 오른쪽 하단 모서리에 작은 대각선 텍스처 선으로 렌더링됩니다. 페인트 이벤트는 event 매개변수를 통해 전달됩니다.

[override virtual] void QSizeGrip::setVisible(bool visible)

QWidget::visible 속성에 대한 액세스 함수를 재구현합니다.

[override virtual protected] void QSizeGrip::showEvent(QShowEvent *showEvent)

QWidget::showEvent(QShowEvent *event)를 재구현합니다.

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

QWidget::sizeHint 속성에 대한 액세스 함수를 다시 구현합니다.

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