QPaintEvent 类

QPaintEvent 类包含绘制事件的参数。 更多...

头文件 #include <QPaintEvent>
CMakefind_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmakeQT += gui
继承 QEvent

公共函数

QPaintEvent(const QRegion &paintRegion)
QPaintEvent(const QRect &paintRect)
const QRect &rect() const
const QRegion &region() const

详细说明

绘制事件会发送到需要更新自己的小部件，例如当覆盖小部件移动时导致部分小部件被暴露。

事件包含一个需要更新的 region()，以及一个该区域的边界矩形 rect()。两者都提供，因为很多小部件无法充分利用 region()，而且 rect() 比使用 region().boundingRect() 快得多。

自动裁剪

在处理绘制事件期间，绘制将被裁剪到 region()。这种裁剪是由 Qt 的绘制系统执行的，且与为在绘制设备上绘制而使用的 QPainter 上的任何裁剪无关。

因此，新构建的 QPainter 上 QPainter::clipRegion() 返回的值不会反映绘制系统使用的裁剪区域。

另请参阅QPainter，QWidget::update，QWidget::repaint 以及 QWidget::paintEvent。

成员函数文档

[显式] QPaintEvent::QPaintEvent(const QRegion &paintRegion)

使用指定的 paintRegion 创建一个需要更新的区域的绘制事件对象。

[显式] QPaintEvent::QPaintEvent(const QRect &paintRect)

使用需要更新的矩形构建一个绘图事件对象。区域通过 paintRect 指定。

const QRect &QPaintEvent::rect() const

返回需要更新的矩形。

另请参阅 区域() 和 QPainter::setClipRect().

const QRegion &QPaintEvent::region() const

返回需要更新的区域。

另请参阅 矩形() 和 QPainter::setClipRegion().

© 2024 Qt 公司版权所有。其中的文档贡献版权属于各自的所有者。本提供的文档根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款提供。Qt及其相应标志是芬兰和/或其他国家的Qt公司商标。所有其他商标均为其各自所有者的财产。