QPainter详解

欢迎大家来到IT世界,在知识的湖畔探索吧!

一、描述

1、QPainter 类在小部件和其他绘制设备上执行低级绘制。

2、QPainter 提供了高度优化的功能来完成大多数图形GUI程序所需的工作。它可以画从简单的线条到复杂的形状。它还可以绘制对齐的文本和像素图。QPainter 可以对继承 QPaintDevice 类的任何对象进行操作。

3、QPainter 与 QPaintDevice 和 QPaintEngine 类一起构成了Qt绘制系统的基础：

• QPainter 是用于执行绘图操作的类。
• QPaintDevice 表示可以使用 QPainter 在其上绘制的设备。
• QPaintEngine 提供了一个接口，QPainter 可以使用这个接口来绘制不同类型的设备。

二、类型成员

1、QPainter::CompositionMode。图像合成支持的模式。从实用的角度来看，默认的设置是最好的设置。官方有个“Composition Modes”例子展示了各种模式的效果。

2、QPainter::PixmapFragmentHint。

OpaqueHint。指示要绘制的 pixmap 片段是不透明的。不透明碎片可能会更快地绘制。

3、QPainter::RenderHint。指定 QPainter 的标志，绘制引擎可能会或不会遵守这些标志。

Antialiasing：图像边缘抗锯齿。

TextAntialiasing：文本抗锯齿。要强行禁用文本的抗锯齿功能，请不要设置：

setRenderHint(QPainter::TextAntialiasing, false);

欢迎大家来到IT世界,在知识的湖畔探索吧!

而是应该在字体的样式策略上设置：

欢迎大家来到IT世界,在知识的湖畔探索吧!auto font = this->font(); font.setStyleHint(font.styleHint(),QFont::NoAntialias);

• SmoothPixmapTransform：指示引擎应使用平滑 pixmap 变换算法绘制图片。
• LosslessImageRendering：尽可能使用无损图像渲染。目前，此提示仅在使用 QPainter 通过QPrinter 或 QPdfWriter 输出PDF文件时使用。

三、实用成员函数

1、QPainter(QPaintDevice *device)

构造一个立即开始绘制绘制设备的QPainter对象。此构造函数对于临时的绘制者很方便，并且应该只使用一次。

构造函数自动调用 begin()，析构函数自动调用 end()。

以下代码效果一样：

QPainter p; p.begin(this); p.drawLine(...); p.end(); QPainter p(this); p.drawLine(...);

2、bool begin(QPaintDevice *device)

开始绘制绘画设备，如果成功则返回true，否则返回false。请注意，在调用 begin()时，所有绘画工具设置（setPen()、setBrush()等）都将重置为默认值。

调用此函数可能存在的错误：

欢迎大家来到IT世界,在知识的湖畔探索吧!painter->begin(nullptr); //错误，绘制设备为空 QPixmap image(0, 0); painter->begin(&image); //错误，图片为空 painter->begin(myWidget); painter2->begin(myWidget); //错误，同一时间不能由两个QPainter绘制同一设备

注：不支持在格式为 QImage::Format_Indexed8 的 QImage 上绘制。

3、QRectF boundingRect(const QRectF &rectangle, int flags, const QString &text)

返回使用当前设置的 font() 使用指定标志在给定矩形内部绘制时显示的文本的边界矩形。

即该函数告诉您在给定相同参数的情况下 drawText() 函数将在何处绘制。如果使用指定的标志文本不适合给定的矩形，则该函数返回所需的矩形。flags 参数见下面的第30点。

void Widget::paintEvent(QPaintEvent *event) { QPainter painter(this); painter.setPen(QPen(Qt::red,5)); QRect rect = QRect(20,20,100,50); painter.drawRect(rect); QFont font = this->font(); font.setPointSize(30); painter.setFont(font); painter.drawText(rect,Qt::AlignHCenter | Qt::TextWordWrap,"黄河之水天上来"); painter.setPen(QPen(Qt::green,5)); auto bRect = painter.boundingRect(rect,Qt::AlignHCenter | Qt::TextWordWrap,"黄河之水天上来"); painter.drawRect(bRect); }

欢迎大家来到IT世界,在知识的湖畔探索吧!

红框是设置的要绘制的矩形。不过字太大了只能绘制两个字，绿色是要绘制这句诗实际上需要的边界矩形。

4、QPoint brushOrigin()

获取绘制开始的点。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing,true); painter.setPen(QPen(Qt::red,5)); painter.drawEllipse(painter.brushOrigin(),5,5); painter.translate(50,50); painter.drawEllipse(painter.brushOrigin(),5,5); painter.setBrushOrigin(100,100); painter.drawEllipse(painter.brushOrigin(),5,5);

5、void setClipRect(const QRectF &rectangle, Qt::ClipOperation operation = Qt::ReplaceClip)

启用剪辑，并使用给定的剪辑操作将剪辑区域设置为给定的矩形。

裁剪操作 Qt::ClipOperation：

• Qt::NoClip：关闭裁剪。
• Qt::ReplaceClip：将当前的裁剪路径/矩形/区域替换为函数调用中提供的路径/矩形/区域。
• Qt::IntersectClip：与当前裁剪路径/矩形/区域与函数调用中提供的路径相交。

void Widget::paintEvent(QPaintEvent *event) { auto rect = event->rect(); QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing,true); painter.setPen(QPen(Qt::red,5)); painter.setClipRect(rect.adjusted(20,20,-20,-20)); painter.drawLine(rect.topLeft(),rect.bottomRight()); }

6、void setClipPath(const QPainterPath &path, Qt::ClipOperation operation = Qt::ReplaceClip)

设置裁剪路径。

欢迎大家来到IT世界,在知识的湖畔探索吧!void Widget::paintEvent(QPaintEvent *event) { auto rect = event->rect(); QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing,true); painter.setBrush(Qt::cyan); QPainterPath path; path.addRoundRect(rect.adjusted(20,20,-20,-20),60,60); painter.setClipPath(path); painter.drawRect(rect); }

7、void setClipRegion(const QRegion ®ion, Qt::ClipOperation operation = Qt::ReplaceClip)

设置裁剪区域，见 QRegion详解

8、void drawArc(const QRect &rect, int startAngle, int lenAngle)

绘制圆弧。

QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing,true); painter.setPen(QPen(Qt::red,5)); QRectF rectangle(10.0, 20.0, 80.0, 60.0); int startAngle = 30 * 16; int spanAngle = 120 * 16; painter.drawArc(rectangle, startAngle, spanAngle); painter.setPen(QPen(Qt::blue,3,Qt::DotLine)); painter.drawRect(rectangle);

9、void drawChord(const QRectF &rectangle, int startAngle, int spanAngle)

绘制扇形，参数含义和绘制弧形一样。

欢迎大家来到IT世界,在知识的湖畔探索吧!painter.drawChord(rectangle, startAngle, spanAngle);

10、void drawConvexPolygon(const QPointF *points, int pointCount)

绘制凸多边形（凸多边形的内角均小于或等于180°）。第一个点隐式连接到最后一个点，并且多边形被当前的brush()填充。

QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing,true); painter.setPen(QPen(Qt::red,3)); static const QPointF points[4] = { QPointF(10.0, 80.0), QPointF(20.0, 10.0), QPointF(80.0, 30.0), QPointF(90.0, 70.0)}; painter.drawConvexPolygon(points, 4); 

11、void drawConvexPolygon(const QPolygonF &polygon)

绘制凸多边形，重载函数。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPolygonF polygon; polygon.append(QPointF(10.0, 80.0)); polygon.append(QPointF(20.0, 10.0)); polygon.append(QPointF(80.0, 60.0)); painter.drawConvexPolygon(polygon);

12、void drawEllipse(const QRectF &rectangle)

绘制椭圆，参数是椭圆的外切矩形。

13、void drawEllipse(const QPointF ¢er, qreal rx, qreal ry)

绘制椭圆，参数为椭圆的中心和x、y方向的半径。

14、void drawImage(const QRectF &target, const QImage &image, const QRectF &source, Qt::ImageConversionFlags flags = Qt::AutoColor)

将给定图像的矩形部分（参数3）源绘制到绘制设备中的目标矩形（参数1）中。如果图像和矩形尺寸不相同，则将图像缩放以适合矩形。

QPainter painter(this); QImage img(":/D:/eee.jpg"); QRectF r{40,40,100,200}; painter.drawImage(r,img);

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); QImage img(":/D:/eee.jpg"); QRectF r{40,40,100,200}; painter.drawImage(r,img,QRectF(30,30,200,400));

15、void drawLine(const QLineF &line)

绘制直线。QLineF

16、void drawPath(const QPainterPath &path)

使用当前的笔绘制轮廓并使用当前的笔刷绘制路径。QPainterPath

17、void drawPie(const QRectF &rectangle, int startAngle, int spanAngle)

绘制扇形。扇形被当前的 brush()填充。必须以度的1/16来指定startAngle和spanAngle，即一个完整的圆等于5760（16 * 360）。角度的正值表示逆时针方向，而负值表示顺时针方向。参考上面的 drawArc()示意图。

QPainter painter(this); QRectF rectangle(10.0, 20.0, 80.0, 60.0); int startAngle = 30 * 16; int spanAngle = 120 * 16; painter.setPen(QPen(Qt::red,5)); painter.drawPie(rectangle, startAngle, spanAngle); painter.setPen(QPen(Qt::blue,3,Qt::DotLine)); painter.drawRect(rectangle);

18、void drawPixmap(const QRectF &target, const QPixmap &pixmap, const QRectF &source)

将给定像素图的矩形部分源绘制到绘画设备中的给定目标中。如果像素图和矩形大小不相同，则将像素图缩放为适合矩形。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); QPixmap img(":/D:/eee.jpg"); QRectF r{40,40,100,200}; painter.drawPixmap(r,img,QRectF(30,30,200,400));

19、void drawPixmap(const QPointF &point, const QPixmap &pixmap, const QRectF &source)

在参数1的点处开始绘制参数3指定的图片区域，不会缩放。

QPainter painter(this); QPixmap img(":/D:/eee.jpg"); painter.drawPixmap(QPointF(40,40),img,QRectF(30,30,200,400));

20、void drawPixmap(const QPointF &point, const QPixmap &pixmap)

在给定点开始绘制图片，不会缩放。

21、void drawPixmap(const QRect &rectangle, const QPixmap &pixmap)

在矩形区域绘制图片，会缩放。

【领QT开发教程学习资料，点击下方链接莬费领取↓↓，先码住不迷路~】

点击这里：「链接」

22、void drawPoint(const QPointF &position)

绘制点。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(QPen(Qt::red,5)); painter.drawPoint(QPointF(40,40)); painter.setPen(QPen(Qt::red,15)); painter.drawPoint(QPointF(60,60));

22、void drawPoints(const QPointF *points, int pointCount)

绘制数组中的点。

QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(QPen(Qt::red,5)); static const QPointF points[4] = { QPointF(10.0, 80.0), QPointF(20.0, 10.0), QPointF(80.0, 30.0), QPointF(90.0, 70.0) }; painter.drawPoints(points, 4);

23、void drawPoints(const QPolygonF &points)

绘制多边形中的点。

24、void drawPolygon(const QPolygonF &points, Qt::FillRule fillRule = Qt::OddEvenFill)

绘制多边形。QPolygon

25、void drawPolyline(const QPointF *points, int pointCount)

绘制折线。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(QPen(Qt::red,5)); static const QPointF points[3] = { QPointF(10.0, 80.0), QPointF(20.0, 10.0), QPointF(80.0, 30.0), }; painter.drawPolyline(points, 3);

26、void drawPolyline(const QPolygonF &points)

绘制折线。

QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(QPen(Qt::red,5)); QPolygon polygon = QPolygon(); polygon << QPoint(22,33)< 
   

27、void drawRect(const QRectF &rectangle)

绘制矩形。QRectF

28、void drawRoundedRect(const QRectF &rect, qreal xRadius, qreal yRadius, Qt::SizeMode mode = Qt::AbsoluteSize)

绘制圆角矩形。见QPainterPath

29、void drawText(const QPointF &position, const QString &text)

从给定位置开始，以当前定义的文本方向绘制给定文本。此函数不处理换行符（\ n），因为它不能将文本分成多行，也不能显示换行符。默认情况下，QPainter绘制抗锯齿的文本。

30、void drawText(const QRectF &rectangle, int flags, const QString &text, QRectF *boundingRect = nullptr)

在提供的矩形内绘制给定的文本。矩形以及对齐标记定义了文本的锚点。

欢迎大家来到IT世界,在知识的湖畔探索吧!auto rect = event->rect(); QPainter painter(this); painter.setPen(QPen(Qt::red,5)); painter.drawText(rect, Qt::AlignCenter, "黄河之水天上来\n奔流到海不复回");

参数4是绘制的文本的外接矩形，例：

auto rect = event->rect(); QPainter painter(this); painter.setPen(QPen(Qt::red,5)); QRectF boundingRect; painter.drawText(rect, Qt::AlignCenter, "黄河之水天上来\n奔流到海不复回", &boundingRect); painter.setPen(QPen(Qt::cyan,3,Qt::DotLine)); painter.drawRect(boundingRect);

参数2文本标识单独使用时的效果：

欢迎大家来到IT世界,在知识的湖畔探索吧!Qt::AlignLeft：文本靠左。 Qt::AlignRight：文本靠右。 void Widget::paintEvent(QPaintEvent *event) { auto rect = event->rect(); QPainter painter(this); painter.setPen(QPen(Qt::red,5)); QFont font; font.setPixelSize(40); painter.setFont(font); painter.drawText(rect,Qt::AlignRight, "黄河之水天上来\n奔流到海不复回哈哈哈"); }

• Qt::AlignHCenter：水平方向居中。
• Qt::AlignJustify：两端对齐，无效，原因未知。

• Qt::AlignTop：文本靠上。
• Qt::AlignBottom：文本靠下。
• Qt::AlignVCenter：垂直方向居中。

• Qt::AlignCenter：水平和垂直方向居中。
• Qt::TextSingleLine：保持文本单行，把换行符当做空格。

painter.drawText(rect,Qt::TextSingleLine, "黄河之水天上来\n奔流到海不复回哈哈哈");

Qt::TextExpandTabs：这个资料语焉不详，我推测作用是复制一个制表符。

欢迎大家来到IT世界,在知识的湖畔探索吧!void Widget::paintEvent(QPaintEvent *event) { auto rect = event->rect(); QPainter painter(this); painter.setPen(QPen(Qt::red,5)); QFont font; font.setPixelSize(40); painter.setFont(font); QString text = "A\tA"; painter.drawText(rect,Qt::TextExpandTabs, text); painter.drawText(QPointF(0,80),text); auto bRect = painter.boundingRect(rect,Qt::TextExpandTabs,text); painter.drawRect(bRect); }

使用这个标识之后多出了一个制表符空间。

Qt::TextShowMnemonic：将字符串“&P”显示为P。对于&号，请使用“&&”。例：

QString text = "&ABC"; painter.drawText(rect,Qt::TextShowMnemonic, text); painter.drawText(QPointF(0,80),text);

Qt::TextWordWrap：文字自动换行。

31、void drawText(const QRectF &rectangle, const QString &text, const QTextOption &option = QTextOption())。

欢迎大家来到IT世界,在知识的湖畔探索吧!QTextOption option(Qt::AlignLeft | Qt::AlignVCenter); option.setTextDirection(Qt::RightToLeft); painter.drawText(rect,"黄河之水天上来",option);

32、void drawTiledPixmap(const QRectF &rectangle, const QPixmap &pixmap, const QPointF &position = QPointF())

绘制平铺图片。绘制从图片中参数3的位置开始绘制。

QPixmap pixmap(":/D:/.PNG"); painter.drawTiledPixmap(rect,pixmap,QPointF(100,100));

33、void eraseRect(const QRectF &rectangle)

擦除区域。

相当于：

欢迎大家来到IT世界,在知识的湖畔探索吧!fillRect(rectangle, background());

34、bool end()

结束绘画。 释放绘画时使用的所有资源。

35、void fillPath(const QPainterPath &path, const QBrush &brush)

填充路径，但不绘制轮廓。

QPainterPath path; path.cubicTo(QPointF(0,0),QPointF(200,200),QPointF(150,20)); painter.fillPath(path,Qt::cyan);

36、void fillRect(const QRect &rectangle, const QBrush &brush)

填充矩形，可用颜色、画刷、渐变、画刷类型填充。

37、bool isActive()

是否已调用 begin() 而尚未调用 end()。

38、void resetTransform()

重置使用 translate()，scale()，shear()，rotate()，setWorldTransform()，setViewport() 和setWindow() 进行的所有转换。

39、void restore()

恢复当前的QPainter状态（从堆栈弹出保存的状态）。

40、void save()

保存当前的画家状态（将状态推送到堆栈上）。 在save()之后必须有一个相应的restore()。（end()函数会展开堆栈）

41、void rotate(qreal angle)

顺时针旋转坐标系。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); painter.setPen(QPen(Qt::red,5)); painter.translate(150,150); painter.drawText(QPointF(0,0),"黄河之水天上来"); painter.rotate(90); painter.drawText(QPointF(0,0),"黄河之水天上来"); painter.rotate(90); painter.drawText(QPointF(0,0),"黄河之水天上来"); painter.rotate(90); painter.drawText(QPointF(0,0),"黄河之水天上来");

42、void scale(qreal sx, qreal sy)

坐标x、y轴缩放相应比例。

43、void setBackground(const QBrush &brush)

设置背景画刷。背景画刷是在绘制不透明文本、填充画刷样式和绘制位图时填充的画刷。背景笔刷在透明背景模式下没有效果（默认设置）。

void Widget::paintEvent(QPaintEvent *event) { auto rect = event->rect(); QPainter painter(this); painter.setBackgroundMode(Qt::OpaqueMode); painter.setBackground(Qt::cyan); painter.fillRect(rect,Qt::CrossPattern); }

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); painter.setBackgroundMode(Qt::OpaqueMode); painter.setBackground(Qt::cyan); painter.setPen(QPen(Qt::red,5)); painter.drawText(QPointF(55,55),"黄河之水天上来");

绘制位图：

auto rect = event->rect(); QPainter painter(this); painter.setBackgroundMode(Qt::OpaqueMode); painter.setBackground(Qt::cyan); QBitmap img(":/D:/q.jpeg"); painter.drawPixmap(rect,img);

44、void setBackgroundMode(Qt::BGMode mode)。

设置背景模式。

• Qt::BGMode：
• Qt::TransparentMode：（默认设置）绘制不透明文本、填充画刷样式和绘制位图时无需设置背景像素。

Qt::OpaqueMode：用当前背景色填充不透明文本、画刷样式和位图的背景像素。

45、void setOpacity(qreal opacity)

设置透明度。值为0.0~1.0。

46、void setWorldTransform(const QTransform &transform, bool combine = false)

设置变换矩阵。见 QTransform。如果参数2是true，将与当前矩阵的变换效果合并，否则替换当前变换矩阵。

欢迎大家来到IT世界,在知识的湖畔探索吧!QPainter painter(this); auto rectPoint = event->rect().center(); QTransform transform; transform.translate(rectPoint.x(),rectPoint.y()); painter.setWorldTransform(transform); QTransform transform2; transform2.rotate(45); painter.setWorldTransform(transform2,true); painter.setPen(QPen(Qt::cyan, 3, Qt::DashDotLine)); painter.drawRect(0, 0, 100, 100);

设置了两个变换矩阵，一个效果是平移，一个效果是旋转，第一次设置平移效果，第二次设置旋转和平移效果合并，即有平移和旋转两种效果。

注：setTransform() 和 setWorldTransform()这俩没区别，查看源码发现 setTransform() 实际上就是调用 setWorldTransform()：

47、void setWindow(const QRect &rectangle)

设置窗口转换矩形。见窗口-视口转换

48、void setViewTransformEnabled(bool enable)

设置是否启用窗口-视口转换。设置为 false 则相当于 setWindow() 的设置无效。

49、void setViewport(const QRect &rectangle)

设置视口。见窗口-视口转换

50、void setWorldMatrixEnabled(bool enable)

设置是否启用变换矩阵，设为 false则 相当于 setTransform() 的设置无效。

51、void shear(qreal sh, qreal sv)

剪切坐标，见 QTransform

52、void strokePath(const QPainterPath &path, const QPen &pen)

使用指定的画笔描绘路径轮廓，其内部实际上是调用 drawPath()。

53、void translate(qreal dx, qreal dy)

平移绘制坐标。

QPainter painter(this); painter.translate(50,50); painter.drawText(QPointF(0,0),"黄河之水天上来");

【领QT开发教程学习资料，点击下方链接莬费领取↓↓，先码住不迷路~】

点击这里：「链接」

原文链接：https://blog.csdn.net/kenfan1647/article/details/