一、描述

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);

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

    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()等）都将重置为默认值。

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

 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);
}

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

4、QPoint brushOrigin()

获取绘制开始的点。

    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)

设置裁剪路径。

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 &region, 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)

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

    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)

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

    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 &center, 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);

    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)

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

    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)

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

22、void drawPoint(const QPointF &position)

绘制点。

    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)

绘制折线。

    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)<<QPoint(78,45)<<QPoint(111,233)<<QPoint(234,88)<<QPoint(34,89);painter.drawPolyline(polygon);

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)

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

    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文本标识单独使用时的效果：

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：这个资料语焉不详，我推测作用是复制一个制表符。

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())。

    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:/666666.PNG");painter.drawTiledPixmap(rect,pixmap,QPointF(100,100));

33、void eraseRect(const QRectF &rectangle)

擦除区域。

相当于：

    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)

顺时针旋转坐标系。

    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);
}

    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:/qqq.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，将与当前矩阵的变换效果合并，否则替换当前变换矩阵。

    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),"黄河之水天上来");

QPainter详解相关推荐

python绘制散点图的函数_Python用PyQt5绘制多彩随机散点图，基本控件之QPainter使用详解...
前面内容,我们详细介绍了PyQt5中弹出式对话框. 回顾下精彩内容 Python用PyQt5制作颜色对话框,PyQt图形界面编程之QColorDialog Qt图形界面编程之QFileDialog类, ...
qchart折现图_Qt开发技术：QCharts（二）QCharts折线图介绍、Demo以及代码详解
若该文为原创文章,未经允许不得转载各位读者,知识无穷而人力有穷,要么改需求,要么找专业人士,要么自己研究敬请期待- 红胖子,来也! 介绍了整体框架,开始动手码代码,按照顺序,从折线图开始. QCh ...
Qt开发技术：图形视图框架（二）场景QGraphicsScene、QGraphicsItem与QGraphicsView详解
若该文为原创文章,转载请注明原文出处本文章博客地址:https://hpzwl.blog.csdn.net/article/details/117660217 长期持续带来更多项目与技术分享,咨询请 ...
Qt开发技术：QCharts（三）QCharts样条曲线图介绍、Demo以及代码详解
若该文为原创文章,转载请注明原文出处本文章博客地址:https://blog.csdn.net/qq21497936/article/details/108022984 各位读者,知识无穷而人力有穷 ...
pythongui日历控件_“五一”快到了，用Python中PyQt5做一个日历，QCalendar控件详解...
前面内容,我们详细了解了PyQt5中的一些常用控件精彩内容回顾 Python用PyQt5设计界面,如何正确显示一幅图片,QPixmap控件详解拥有漂亮的笔刷才能绘制多彩界面,PythonPyQt5 ...
详解qtopia4.4.3移植到mips处理器以及相关问题总结
最近公司做一个linux手机项目,需要做一个图形界面程序,移植qtopia,其中遇到一些难题也折腾了1个多星期,总算是弄好了,这里总结一下.分为以下几部分: 1 编译运行x86版本的qtopia 2 ...
Qt图形视图框架：QGraphicsScene详解
一.描述 1.场景提供了一个用于管理大量2D图形项的平面.该类充当图形项的容器. 它与视图一起用于可视化2D曲面上的图形图形项. 2.场景没有自己的视觉外观,只负责管理图形项. 3.场景的最大优势之一 ...
100行实现《贪吃蛇》小游戏详解（Qt）
目录游戏说明游戏效果展示游戏代码详解关键数据结构初始化游戏界面游戏部分提示部分蛇逻辑小蛇的初始化边界判断蛇吃食物判断随机生成食物是否撞到自己小蛇的移动游戏主体逻辑定时 ...
从命令行到IDE，版本管理工具Git详解（远程仓库创建+命令行讲解+IDEA集成使用）
首先,Git已经并不只是GitHub,而是所有基于Git的平台,只要在你的电脑上面下载了Git,你就可以通过Git去管理"基于Git的平台"上的代码,常用的平台有GitHub.Gi ...
JVM年轻代，老年代，永久代详解
秉承不重复造轮子的原则,查看印象笔记分享连接↓↓↓↓ 传送门:JVM年轻代,老年代,永久代详解速读摘要最近被问到了这个问题,解释的不是很清晰,有一些概念略微模糊,在此进行整理和记录,分享给大家.在 ...

QPainter详解

一、描述

二、类型成员

三、实用成员函数

QPainter详解相关推荐

最新文章

热门文章