QPaintEngine Class

成员函数文档

[explicit] QPaintEngine::QPaintEngine(QPaintEngine::PaintEngineFeatures caps = PaintEngineFeatures())

创建一个具有由caps 指定的功能集的绘图引擎。

[virtual noexcept] QPaintEngine::~QPaintEngine()

破坏了绘图引擎。

[pure virtual] bool QPaintEngine::begin(QPaintDevice *pdev)

请重写此函数，以便在绘制设备pdev 上开始绘制时初始化您的绘制引擎。如果初始化成功，则返回 true；否则返回 false。

另请参阅 end() 和isActive()。

[virtual] void QPaintEngine::drawEllipse(const QRectF &rect)

重写此函数，以绘制能够完全容纳于矩形rect 内的最大椭圆。

默认实现会调用drawPolygon()。

[virtual] void QPaintEngine::drawEllipse(const QRect &rect)

该函数的默认实现会调用该函数的浮点版本

[virtual] void QPaintEngine::drawImage(const QRectF &rectangle, const QImage &image, const QRectF &sr, Qt::ImageConversionFlags flags = Qt::AutoColor)

重写此函数，以使用给定的转换标志flags ，将image 中由矩形sr 指定的部分绘制到给定的rectangle 中，并将其转换为位图。

[virtual] void QPaintEngine::drawLines(const QLineF *lines, int lineCount)

默认实现会将lines 中的行列表拆分为lineCount 个独立的调用，具体调用drawPath()或drawPolygon()取决于绘图引擎的功能集。

[virtual] void QPaintEngine::drawLines(const QLine *lines, int lineCount)

默认实现将lines 中的前lineCount 行转换为QLineF ，并调用该函数的浮点版本。

[virtual] void QPaintEngine::drawPath(const QPainterPath &path)

默认实现会忽略path 方法，并不执行任何操作。

[pure virtual] void QPaintEngine::drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr)

重写此函数，以在给定的r 中绘制由sr 矩形指定的pm 部分。

[virtual] void QPaintEngine::drawPoints(const QPoint *points, int pointCount)

在缓冲区中绘制前pointCount 个点points

默认实现会将points 中前pointCount 个QPoint转换为QPointF，并调用drawPoints的浮点版本。

[virtual] void QPaintEngine::drawPoints(const QPointF *points, int pointCount)

在缓冲区中绘制前pointCount 个点points

[virtual] void QPaintEngine::drawPolygon(const QPointF *points, int pointCount, QPaintEngine::PolygonDrawMode mode)

重写此虚函数，以使用模式 `mode` 绘制由 `pointCount ` 中的 `points` 中的前几个点定义的多边形。

[virtual] void QPaintEngine::drawPolygon(const QPoint *points, int pointCount, QPaintEngine::PolygonDrawMode mode)

重写此虚函数，以使用模式 `mode` 绘制由 `pointCount ` 中的 `points` 中的前几个点定义的多边形。

[virtual] void QPaintEngine::drawRects(const QRectF *rects, int rectCount)

在缓冲区rects 中绘制前rectCount 个矩形。该函数的默认实现会根据绘图引擎的功能集，调用drawPath()或drawPolygon()。

[virtual] void QPaintEngine::drawRects(const QRect *rects, int rectCount)

默认实现将缓冲区rects 中的前rectCount 个矩形转换为QRectF ，并调用该函数的浮点版本。

[virtual] void QPaintEngine::drawTextItem(const QPointF &p, const QTextItem &textItem)

该函数在坐标p 处绘制文本项textItem 。该函数的默认实现会将文本转换为QPainterPath ，并绘制生成的路径。

[virtual] void QPaintEngine::drawTiledPixmap(const QRectF &rect, const QPixmap &pixmap, const QPointF &p)

重写此函数，以便在给定的rect 中绘制pixmap ，起始位置为给定的p 。将反复绘制该像素图，直到rect 被填满。

[pure virtual] bool QPaintEngine::end()

重写此函数以完成在当前绘制设备上的绘制操作。如果绘制成功，则返回 true；否则返回 false。

另请参阅 begin() 和isActive()。

bool QPaintEngine::hasFeature(QPaintEngine::PaintEngineFeatures feature) const

如果绘制引擎支持指定的feature ，则返回true ；否则返回false 。

bool QPaintEngine::isActive() const

如果绘制引擎正在进行绘制，则返回true ；否则返回false 。

另请参阅 setActive()。

QPaintDevice *QPaintEngine::paintDevice() const

如果绘制操作处于活动状态，则返回该引擎正在进行绘制的设备；否则返回nullptr 。

QPainter *QPaintEngine::painter() const

返回绘图引擎的绘图器。

void QPaintEngine::setActive(bool state)

将绘制引擎的活动状态设置为state 。

另请参阅 isActive()。

[pure virtual] QPaintEngine::Type QPaintEngine::type() const

重写此函数，使其返回绘图引擎Type 。

[pure virtual] void QPaintEngine::updateState(const QPaintEngineState &state)

重写此函数以更新绘制引擎的状态。

实现后，该函数负责检查绘制引擎的当前state ，并更新已发生变化的属性。请使用QPaintEngineState::state()函数确定需要更新的属性，然后使用相应的get function 获取给定属性的当前值。

另请参阅 QPaintEngineState 。