QPaintEvent 类

QPaintEvent 类包含用于描绘事件的事件参数。 更多...

头: #include <QPaintEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
继承: QEvent

公共函数

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

详细描述

描绘事件被发送给需要更新自身的 Widget,例如:当由于移动覆盖 Widget 而暴露小部件部分时。

事件包含 region () 需要更新,和 rect () 相应区域的边界矩形。提供 2 者,是因为很多 Widget 不能充分利用 region (),和 rect () 可以更快相比 region ().boundingRect().

自动裁剪

描绘被裁剪到 region () 在描绘事件处理期间。此裁剪由 Qt 描绘系统履行,且任何独立裁剪可能会应用到 QPainter 用于在描绘设备上绘制。

因此,值返回通过 QPainter::clipRegion () 在新近构造的 QPainter 不会反映由描绘系统所使用的裁剪区域。

另请参阅 QPainter , QWidget::update (), QWidget::repaint (),和 QWidget::paintEvent ().

成员函数文档编制

[explicit] QPaintEvent:: QPaintEvent (const QRegion & paintRegion )

构造描绘事件对象采用需要更新的区域。区域的指定通过 paintRegion .

[explicit] QPaintEvent:: QPaintEvent (const QRect & paintRect )

构造描绘事件对象采用需要更新的矩形。区域的指定通过 paintRect .

const QRect &QPaintEvent:: rect () const

返回需要更新的矩形。

另请参阅 region () 和 QPainter::setClipRect ().

const QRegion &QPaintEvent:: region () const

返回需要更新的区域。

另请参阅 rect () 和 QPainter::setClipRegion ().