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 |
详细信息
此小部件的操作类似于标准的 Windows 调整大小手柄。在 X11 版本中,如果 X11 窗口管理器不支持所需的现代 ICCCM 规范,该调整大小手柄通常与系统提供的调整大小手柄不同。
将此小部件放在小部件树中的任何位置,用户都可以使用它来调整具有 Qt::SubWindow 标志设置的最高级别窗口或任何小部件。通常,这应该在右下角。
请注意,QStatusBar 已经使用了此小部件,因此如果您有状态栏(例如,您正在使用 QMainWindow),那么您不需要明确使用此小部件。对于 QDialog 也适用,您只需调用 QDialog::setSizeGripEnabled()。
在某些平台上,调整大小手柄在窗口全屏或最大化显示时会自动隐藏。
注意:在 macOS 上,尺寸手柄不再属于用户界面指南的一部分,除非在 QMdiSubWindow 中使用,否则不会显示。为要在主窗口中可见的尺寸手柄设置另一种样式。
融合样式的尺寸手柄截图 | 主窗口右下角的一个尺寸手柄小部件,如图所示 Fusion 小部件样式. |
QSizeGrip 类继承自 QWidget 并重写了 mousePressEvent() 和 mouseMoveEvent() 函数以实现调整大小的功能,并重写了 paintEvent() 函数以渲染尺寸手柄小部件。
参见 QStatusBar 和 QWidget::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及其相关标志是芬兰及其在全球的商标,所有其他商标归其各自所有者所有。