QPaintEngineState 类

QPaintEngineState 类提供了关于活动绘图引擎当前状态的信息。更多信息...

头文件	#include <QPaintEngineState>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui

包括继承成员在内的所有成员列表

注意：此类中所有函数都是可重入的。

公共函数

QBrush	backgroundBrush() const
Qt::BGMode	backgroundMode() const
QBrush	brush() const
bool	brushNeedsResolving() const
QPointF	brushOrigin() const
Qt::ClipOperation	clipOperation() const
QPainterPath	clipPath() const
QRegion	clipRegion() const
QPainter::CompositionMode	compositionMode() const
QFont	font() const
bool	isClipEnabled() const
qreal	opacity() const
QPainter *	painter() const
QPen	pen() const
bool	penNeedsResolving() const
QPainter::RenderHints	renderHints() const
QPaintEngine::DirtyFlags	state() const
QTransform	transform() const

详细说明

QPaintEngineState 记录了自上次绘图引擎更新以来哪些属性已更改，以及它们的当前值。

可以通过使用 state() 函数获取任何时间点的更改属性。此函数返回一个 QPaintEngine::DirtyFlags 类型的实例，该实例存储 QPaintEngine::DirtyFlag 值的 OR 组合。该 QPaintEngine::DirtyFlag 枚举定义自上次更新以来是否已更改属性。

如果属性带有脏标志，则可以使用相应的获取函数检索其当前值

属性标志	当前属性值
QPaintEngine::DirtyBackground	backgroundBrush()
QPaintEngine::DirtyBackgroundMode	backgroundMode()
QPaintEngine::DirtyBrush	brush()
QPaintEngine::DirtyBrushOrigin	brushOrigin()
QPaintEngine::DirtyClipRegion 或 QPaintEngine::DirtyClipPath	clipOperation()
QPaintEngine::DirtyClipPath	clipPath()
QPaintEngine::DirtyClipRegion	clipRegion()
QPaintEngine::DirtyCompositionMode	compositionMode()
QPaintEngine::DirtyFont	font()
QPaintEngine::DirtyTransform	transform()
QPaintEngine::DirtyClipEnabled	isClipEnabled()
QPaintEngine::DirtyPen	pen()
QPaintEngine::DirtyHints	renderHints()

QPaintEngineState 类还提供了一个 painter() 函数，它返回指向当前正在更新绘制引擎的绘制器的指针。

此类的实例表示活动的绘制引擎的当前状态，并将其作为参数传递给 QPaintEngine::updateState() 函数。您必须直接使用此类的情况仅当实现自己的绘制引擎时。

另请参阅QPaintEngine。

成员函数文档

QBrush QPaintEngineState::backgroundBrush() const

返回当前绘制引擎状态中的背景画笔。

此变量应在 state() 返回包含 QPaintEngine::DirtyBackground 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

Qt::BGMode QPaintEngineState::backgroundMode() const

返回当前绘制引擎状态中的背景模式。

此变量应在 state() 返回包含 QPaintEngine::DirtyBackgroundMode 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QBrush QPaintEngineState::brush() const

返回当前绘制引擎状态中的画笔。

此变量应在 state() 返回包含 QPaintEngine::DirtyBrush 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

bool QPaintEngineState::brushNeedsResolving() const

返回填充坐标是否被指定为受当前绘制操作限制并需要解决（关于当前绘制的原语）。

QPointF QPaintEngineState::brushOrigin() const

返回当前绘制引擎状态中的画笔原点。

此变量应在 state() 返回包含 QPaintEngine::DirtyBrushOrigin 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

Qt::ClipOperation QPaintEngineState::clipOperation() const

返回当前绘制引擎状态中的裁剪操作。

此变量应在 state() 返回包含 QPaintEngine::DirtyClipPath 或 QPaintEngine::DirtyClipRegion 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QPainterPath QPaintEngineState::clipPath() const

返回当前绘制引擎状态的裁剪路径。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyClipPath 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QRegion QPaintEngineState::clipRegion() const

返回当前绘制引擎状态的裁剪区域。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyClipRegion 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QPainter::CompositionMode QPaintEngineState::compositionMode() const

返回当前绘制引擎状态的合成模式。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyCompositionMode 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QFont QPaintEngineState::font() const

返回当前绘制引擎状态的字体。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyFont 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

bool QPaintEngineState::isClipEnabled() const

返回当前绘制引擎状态中是否启用了裁剪。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyClipEnabled 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

qreal QPaintEngineState::opacity() const

返回当前绘制引擎状态的透明度。

QPainter *QPaintEngineState::painter() const

返回当前更新绘制引擎的绘制者的指针。

QPen QPaintEngineState::pen() const

返回当前绘制引擎状态的画笔。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyPen 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

bool QPaintEngineState::penNeedsResolving() const

返回笔画坐标是否已指定为当前渲染操作的限制，并需要解决（关于当前渲染的原型）。

QPainter::RenderHints QPaintEngineState::renderHints() const

返回当前绘制引擎状态的渲染提示。

此变量仅在调用 state() 返回一个包含 QPaintEngine::DirtyHints 标志的组合时使用。

另请参阅state() 和 QPaintEngine::updateState。

QPaintEngine::DirtyFlags QPaintEngineState::state() const

返回一组标识标识了在更新绘制引擎状态时（即在调用QPaintEngine::updateState() 函数时）需要更新的属性集。

另请参阅 QPaintEngine::updateState。

QTransform QPaintEngineState::transform() const

返回当前绘制引擎状态中的矩阵。

仅在state() 返回一个包含 QPaintEngine::DirtyTransform 标志的组合时才应使用此变量。

另请参阅state() 和 QPaintEngine::updateState。

© 2024 Qt 公司。本文件中的文档贡献属于其各自的版权所有者。本文件所提供文档许可证受GNU 自由文档许可证版本 1.3 的约束，该许可证由自由软件基金会发布。Qt及其相关徽标是芬兰以及其他国家和地区的Qt公司的注册商标。所有其他商标均属于其各自的拥有者。