QSizeGrip 类

QSizeGrip 类提供了一个用于调整顶级窗口大小的调整手柄。 更多...

头文件 #include <QSizeGrip>
CMakefind_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmakeQT += widgets
继承 QWidget

公共函数

QSizeGrip(QWidget *parent)
virtual~QSizeGrip()

重新实现了公共函数

virtual voidsetVisible(bool visible) override
virtual QSizesizeHint() const override

重新实现了受保护的函数

virtual boolevent(QEvent *event) override
virtual booleventFilter(QObject *o, QEvent *e) override
virtual voidhideEvent(QHideEvent *hideEvent) override
virtual voidmouseMoveEvent(QMouseEvent *event) override
virtual voidmousePressEvent(QMouseEvent *event) override
virtual voidmouseReleaseEvent(QMouseEvent *mouseEvent) override
virtual voidmoveEvent(QMoveEvent *moveEvent) override
virtual voidpaintEvent(QPaintEvent *event) override
virtual voidshowEvent(QShowEvent *showEvent) override

详细信息

此小部件的操作类似于标准的 Windows 调整大小手柄。在 X11 版本中,如果 X11 窗口管理器不支持所需的现代 ICCCM 规范,该调整大小手柄通常与系统提供的调整大小手柄不同。

将此小部件放在小部件树中的任何位置,用户都可以使用它来调整具有 Qt::SubWindow 标志设置的最高级别窗口或任何小部件。通常,这应该在右下角。

请注意,QStatusBar 已经使用了此小部件,因此如果您有状态栏(例如,您正在使用 QMainWindow),那么您不需要明确使用此小部件。对于 QDialog 也适用,您只需调用 QDialog::setSizeGripEnabled()。

在某些平台上,调整大小手柄在窗口全屏或最大化显示时会自动隐藏。

注意:在 macOS 上,尺寸手柄不再属于用户界面指南的一部分,除非在 QMdiSubWindow 中使用,否则不会显示。为要在主窗口中可见的尺寸手柄设置另一种样式。

融合样式的尺寸手柄截图主窗口右下角的一个尺寸手柄小部件,如图所示 Fusion 小部件样式.

QSizeGrip 类继承自 QWidget 并重写了 mousePressEvent() 和 mouseMoveEvent() 函数以实现调整大小的功能,并重写了 paintEvent() 函数以渲染尺寸手柄小部件。

参见 QStatusBarQWidget::windowState()。

成员函数文档

[显式构造函数] QSizeGrip::QSizeGrip(QWidget *parent)

将调整大小角落作为一个给定 parent 的子小部件构造。

[虚函数 noexcept] QSizeGrip::~QSizeGrip()

销毁此尺寸手柄。

[重写虚保护] bool QSizeGrip::event(QEvent *event)

重写: QWidget::event(QEvent *event).

[重写虚保护] bool QSizeGrip::eventFilter(QObject *o, QEvent *e)

重写: QObject::eventFilter(QObject *watched, QEvent *event).

[重写虚保护] void QSizeGrip::hideEvent(QHideEvent *hideEvent)

重写: QWidget::hideEvent(QHideEvent *event).

[重写虚保护] void QSizeGrip::mouseMoveEvent(QMouseEvent *event)

重写: QWidget::mouseMoveEvent(QMouseEvent *event).

调整包含此小部件的最顶级小部件的大小。鼠标移动事件通过 event 参数传入。

[重写虚保护] void QSizeGrip::mousePressEvent(QMouseEvent *event)

重写: QWidget::mousePressEvent(QMouseEvent *event).

接收小部件的鼠标按下事件,并启动调整大小操作。鼠标按下事件通过 event 参数传入。

[重写虚保护] void QSizeGrip::mouseReleaseEvent(QMouseEvent *mouseEvent)

重写: QWidget::mouseReleaseEvent(QMouseEvent *event).

[重写虚保护] void QSizeGrip::moveEvent(QMoveEvent *moveEvent)

重写: QWidget::moveEvent(QMoveEvent *event).

[重写虚保护] void QSizeGrip::paintEvent(QPaintEvent *event)

重写: QWidget::paintEvent(QPaintEvent *event).

绘制调整大小控制的应用程序。

调整大小控制通常在右下角以小斜纹线条的形式呈现。绘图事件通过event参数传入。

[重写虚] void QSizeGrip::setVisible(bool visible)

重写:QWidget::visible属性的访问函数。

[重写虚保护] void QSizeGrip::showEvent(QShowEvent *showEvent)

重写:QWidget::showEvent(QShowEvent *event).

[重写虚] QSize QSizeGrip::sizeHint() const

重写:QWidget::sizeHint属性的访问函数。

© 2024 Qt公司。此处包含的文档贡献的版权归各自所有者所有。此处提供的文档根据自由软件基金会发布的GNU自由文档许可证第1.3版许可使用。Qt及其相关标志是芬兰及其在全球的商标,所有其他商标归其各自所有者所有。