QSizeGrip 类

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

详细描述

此 Widget 工作像标准 Windows 重置尺寸手柄。在 X11 版本中,此重置尺寸手柄工作通常异于系统提供的,若 X11 窗口管理器不支持必要的现代后 ICCCM 规范。

把此 Widget 放在小部件树的任何地方,用户可以使用它重置尺寸顶层窗口或任何小部件采用 Qt::SubWindow 标志设置。一般来说,它应位于右下角。

注意, QStatusBar 已使用此 Widget,因此若有状态栏 (如,正在使用 QMainWindow ),则不需要明确使用此 Widget。同样适用于 QDialog ,可以仅仅调用 QDialog::setSizeGripEnabled ().

在某些平台,大小握把自动隐藏本身,当窗口全屏或最大化展示时。

注意: On macOS, size grips are no longer part of the human interface guideline, and won't show unless used in a QMdiSubWindow . Set another style on size grips that you want to be visible in main windows.

Screenshot of a Fusion style size grip 大小握把 Widget 位于主窗口右下角,展示在 Fusion 小部件风格 .

QSizeGrip 类继承 QWidget 并重实现 mousePressEvent () 和 mouseMoveEvent () functions to feature the resize functionality, and the paintEvent () function to render the size grip widget.

另请参阅 QStatusBar and QWidget::windowState ().

成员函数文档编制

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

构造作为子级 Widget 的重置尺寸角落为给定 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).

重置尺寸包含此 Widget 的顶层小部件。鼠标移动事件被传入 event 参数。

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

重实现: QWidget::mousePressEvent (QMouseEvent *event).

接收鼠标按下事件为 Widget,并首要重置尺寸操作。鼠标按下事件被传入 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 .