QPainter Class

成员函数文档

QPainter::QPainter()

创建一个画家。

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

[explicit] QPainter::QPainter(QPaintDevice *device)

创建一个绘图器，该绘图器会立即开始绘制device 。

此构造函数适用于短暂存在的绘图器（例如在QWidget::paintEvent() 中），且应仅调用一次。该构造函数会为您调用begin()，而 QPainter 的析构函数会自动调用end()。

以下是一个使用begin() 和end() 的示例：

void MyWidget::paintEvent(QPaintEvent *)
{
    QPainter p;
    p.begin(this);
    p.drawLine(drawingCode);        // drawing code
    p.end();
}

使用该构造函数的相同示例：

void MyWidget::paintEvent(QPaintEvent *)
{
    QPainter p(this);
    p.drawLine(drawingCode);        // drawing code
}

由于构造函数在绘图器初始化失败时无法提供反馈，因此建议您使用begin() 和end() 在外部设备（例如打印机）上进行绘制。

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

[noexcept] QPainter::~QPainter()

摧毁了这位画家。

const QBrush &QPainter::background() const

返回当前的背景画笔。

另请参阅 setBackground() 和Settings 。

Qt::BGMode QPainter::backgroundMode() const

返回当前的背景模式。

另请参阅 setBackgroundMode() 和Settings 。

bool QPainter::begin(QPaintDevice *device)

开始绘制颜色device ，如果成功则返回true ；否则返回false 。

请注意，当调用 begin() 时，所有绘图器设置（setPen()、setBrush() 等）都会重置为默认值。

可能发生的错误都是严重的问题，例如：

painter->begin(nullptr); // impossible - paint device cannot be null

QPixmap image(0, 0);
painter->begin(&image); // impossible - image.isNull() == true;

painter->begin(myWidget);
painter2->begin(myWidget); // impossible - only one painter at a time

请注意，大多数情况下，您可以使用构造函数之一代替 begin()，并且在销毁时会自动执行end()。

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

void QPainter::beginNativePainting()

清空绘制管道，并为用户直接向底层图形上下文发出命令做好准备。此后必须调用endNativePainting()。

请注意，只有底层绘制引擎更改过的状态才会被重置为各自的默认状态。我们重置的状态可能会因版本而异。目前在 OpenGL 2 引擎中，以下状态会被重置：

• 禁用混合
• 深度、模板和剪切测试被禁用
• 活动纹理单元重置为 0
• 深度掩码、深度函数和清除深度被重置为默认值
• 模板掩码、模板运算和模板函数被重置为默认值
• 当前颜色重置为纯白色

例如，如果用户在 beginNativePaint()/endNativePainting() 代码块内更改了 OpenGL 多边形模式，endNativePainting() 并不会将其重置为默认状态。以下示例展示了绘图命令与原始 OpenGL 命令的混合使用：

QPainter painter(this);
painter.fillRect(0, 0, 128, 128, Qt::green);
painter.beginNativePainting();

glEnable(GL_SCISSOR_TEST);
glScissor(0, 0, 64, 64);

glClearColor(1, 0, 0, 1);
glClear(GL_COLOR_BUFFER_BIT);

glDisable(GL_SCISSOR_TEST);

painter.endNativePainting();

另请参阅 endNativePainting()。

QRectF QPainter::boundingRect(const QRectF &rectangle, int flags, const QString &text)

返回text 的边界矩形，该矩形表示当使用当前设置的font()，在给定的rectangle 内，并采用指定的flags 进行绘制时， 的显示效果；也就是说，该函数告诉你，当drawText()函数接收相同的参数时，它将在何处进行绘制。

如果text 无法在使用指定flags 的情况下适配于给定的rectangle 内，则该函数将返回所需的矩形。

flags 参数是以下标志的按位或（OR）运算结果：

• Qt::AlignLeft
• Qt::AlignRight
• Qt::AlignHCenter
• Qt::AlignTop
• Qt::AlignBottom
• Qt::AlignVCenter
• Qt::AlignCenter
• Qt::TextSingleLine
• Qt::TextExpandTabs
• Qt::TextShowMnemonic
• Qt::TextWordWrap
• Qt::TextIncludeTrailingSpaces

如果同时设置了多个水平对齐标志或多个垂直对齐标志，则最终的对齐方式未定义。

另请参阅 drawText()、Qt::Alignment 和Qt::TextFlag 。

QRect QPainter::boundingRect(const QRect &rectangle, int flags, const QString &text)

返回text 的边界矩形，该矩形表示当其被绘制在给定的rectangle 内、使用指定的flags 并采用当前设置的font()时的外观。

QRectF QPainter::boundingRect(const QRectF &rectangle, const QString &text, const QTextOption &option = QTextOption())

该重载函数不再将标志指定为Qt::AlignmentFlag 和Qt::TextFlag 的按位或，而是接受一个option 参数。QTextOption 类提供了对通用富文本属性的描述。

另请参阅 QTextOption 。

QRect QPainter::boundingRect(int x, int y, int w, int h, int flags, const QString &text)

返回给定text 的边界矩形，该矩形将显示为绘制在以点(x,y)为起点的矩形内，该矩形宽度为w ，高度为h 。

const QBrush &QPainter::brush() const

返回画家的当前画笔。

另请参阅 QPainter::setBrush() 和Settings 。

QPoint QPainter::brushOrigin() const

返回当前画笔的原点。建议使用QPainter::brushOriginF() 来获取精确的原点。

另请参阅 setBrushOrigin() 和Settings 。

[since 6.11] QPointF QPainter::brushOriginF() const

返回当前画笔原点。

该函数于 Qt 6.11 中引入。

另请参阅 setBrushOrigin() 和Settings 。

QRectF QPainter::clipBoundingRect() const

如果存在剪切区域，则返回当前剪切区域的边界矩形；否则返回一个空矩形。请注意，剪切区域采用逻辑坐标表示。

不能保证边界矩形是最紧凑的。

另请参阅 setClipRect()、setClipPath() 和setClipRegion()。

QPainterPath QPainter::clipPath() const

返回当前剪辑路径的逻辑坐标。

另请参阅 setClipPath()、clipRegion() 和setClipping()。

QRegion QPainter::clipRegion() const

返回当前设置的剪辑区域。请注意，剪辑区域采用逻辑坐标表示。

另请参阅 setClipRegion()、clipPath() 以及setClipping()。

QTransform QPainter::combinedTransform() const

返回结合了当前窗口/视口变换和世界变换的变换矩阵。

另请参阅 setWorldTransform()、setWindow() 和setViewport()。

QPainter::CompositionMode QPainter::compositionMode() const

返回当前的合成模式。

另请参阅 CompositionMode 和setCompositionMode()。

QPaintDevice *QPainter::device() const

返回该绘图器当前正在绘制的绘图设备；如果该绘图器未处于活动状态，则返回nullptr 。

另请参阅 isActive()。

const QTransform &QPainter::deviceTransform() const

返回将逻辑坐标转换为平台相关绘制设备的设备坐标的矩阵。

仅当在平台相关的句柄（Qt::HANDLE ）上使用平台绘制命令，且该平台本身不进行原生转换时，才需要此函数。

可以通过查询QPaintEngine::PaintEngineFeature 枚举来确定平台是否执行坐标转换。

另请参阅 worldTransform() 和QPaintEngine::hasFeature()。

void QPainter::drawArc(const QRectF &rectangle, int startAngle, int spanAngle)

绘制由给定的rectangle 、startAngle 和spanAngle 定义的圆弧。

startAngle 和spanAngle 必须以1/16度的精度指定，即一整圈等于5760（16 × 360）。角度的正值表示逆时针方向，负值表示顺时针方向。 零度位于3点钟位置。如果rectangle 不是正方形，则这些角度为偏心角，并不表示从矩形中心出发的方向，具体说明请参见Arcs and Ellipses 。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); int startAngle = 30 * 16; int spanAngle = 120 * 16; QPainter painter(this); painter.drawArc(rectangle, startAngle, spanAngle);

另请参阅 drawPie()、drawChord() 以及“坐标系”。

void QPainter::drawArc(const QRect &rectangle, int startAngle, int spanAngle)

绘制由给定的rectangle 、startAngle 和spanAngle 定义的弧。

void QPainter::drawArc(int x, int y, int width, int height, int startAngle, int spanAngle)

绘制由矩形（起始点为 (x,y)）所定义的弧，该弧使用指定的width 和height ，以及给定的startAngle 和spanAngle 。

void QPainter::drawChord(const QRectF &rectangle, int startAngle, int spanAngle)

绘制由给定的rectangle 、startAngle 和spanAngle 定义的弦。该弦将填充为当前的brush()。

startAngle和spanAngle必须以1/16度的精度指定，即一整圈等于5760（16 * 360）。角度的正值表示逆时针方向，负值表示顺时针方向。 零度位于3点钟位置。如果rectangle 不是正方形，则这些角度为偏心角，且不以矩形中心为基准测量方向，具体说明参见Arcs and Ellipses 。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); int startAngle = 30 * 16; int spanAngle = 120 * 16; QPainter painter(this); painter.drawChord(rect, startAngle, spanAngle);

另请参阅 drawArc()、drawPie() 以及“坐标系”。

void QPainter::drawChord(const QRect &rectangle, int startAngle, int spanAngle)

绘制由给定的rectangle 、startAngle 和spanAngle 定义的弦。

void QPainter::drawChord(int x, int y, int width, int height, int startAngle, int spanAngle)

绘制由矩形（起始点为 (x,y)）所定义的弦，该弦的width 和height 已指定，且startAngle 和spanAngle 已给定。

void QPainter::drawConvexPolygon(const QPointF *points, int pointCount)

使用当前画笔绘制由数组points 中前pointCount 个点定义的凸多边形。

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) }; QPainter painter(this); painter.drawConvexPolygon(points, 4);

第一个点将隐式连接到最后一个点，且多边形将使用当前的brush()进行填充。如果给定的多边形不是凸多边形，即包含至少一个大于180度的角，则结果未定义。

在某些平台（例如 X11）上，drawConvexPolygon() 函数的执行速度可能快于drawPolygon() 函数。

另请参阅 drawPolygon()、drawPolyline() 以及坐标系。

void QPainter::drawConvexPolygon(const QPolygon &polygon)

使用当前的笔和画笔绘制由polygon 定义的凸多边形。

void QPainter::drawConvexPolygon(const QPolygonF &polygon)

使用当前的笔和画笔绘制由polygon 定义的凸多边形。

void QPainter::drawConvexPolygon(const QPoint *points, int pointCount)

使用当前画笔绘制由数组points 中前pointCount 个点所定义的凸多边形。

void QPainter::drawEllipse(const QRectF &rectangle)

绘制由给定的rectangle 定义的椭圆。

实心椭圆的大小为rectangle 。size()。带描边的椭圆的大小为rectangle 。size() 加上笔宽。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); QPainter painter(this); painter.drawEllipse(rectangle);

另请参阅 drawPie() 和坐标系。

void QPainter::drawEllipse(const QRect &rectangle)

绘制由给定的rectangle 定义的椭圆。

void QPainter::drawEllipse(const QPoint &center, int rx, int ry)

绘制位于坐标center 、半径分别为rx 和ry 的椭圆。

void QPainter::drawEllipse(const QPointF &center, qreal rx, qreal ry)

绘制一个位于center 、半径分别为rx 和ry 的椭圆。

void QPainter::drawEllipse(int x, int y, int width, int height)

绘制由起始于 (x,y) 的矩形所定义的椭圆，其参数为给定的width 和height 。

void QPainter::drawGlyphRun(const QPointF &position, const QGlyphRun &glyphs)

绘制由glyphs 在position 处表示的字形。position 指定了该字形串的基线边缘。字形将从glyphs 上选定的字体中获取，并根据glyphs 中给定的位置偏移量进行绘制。

另请参阅 QGlyphRun::setRawFont()、QGlyphRun::setPositions() 和QGlyphRun::setGlyphIndexes()。

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

将给定image 的矩形区域source 绘制到绘图设备中的target 矩形内。

如果需要修改图像以适应较低分辨率的结果（例如，从 32 位转换为 8 位），请使用flags 来指定您希望如何进行此操作。

QRectF target(10.0, 20.0, 80.0, 60.0);
QRectF source(0.0, 0.0, 70.0, 40.0);
QImage image(":/images/myImage.png");

QPainter painter(this);
painter.drawImage(target, image, source);

另请参阅 drawPixmap() 和QImage::devicePixelRatio()。

void QPainter::drawImage(const QPoint &point, const QImage &image)

在指定的point 上绘制给定的image 。

void QPainter::drawImage(const QPointF &point, const QImage &image)

在指定的point 上绘制给定的image 。

void QPainter::drawImage(const QRect &rectangle, const QImage &image)

将给定的image 绘制到给定的rectangle 中。

void QPainter::drawImage(const QRectF &rectangle, const QImage &image)

将给定的image 绘制到给定的rectangle 中。

void QPainter::drawImage(const QPoint &point, const QImage &image, const QRect &source, Qt::ImageConversionFlags flags = Qt::AutoColor)

绘制给定矩形区域source ，该区域属于给定的image ，其原点位于给定的point 处。

void QPainter::drawImage(const QPointF &point, const QImage &image, const QRectF &source, Qt::ImageConversionFlags flags = Qt::AutoColor)

绘制给定坐标系image 中以给定点point 为原点的矩形区域source 。

void QPainter::drawImage(const QRect &target, const QImage &image, const QRect &source, Qt::ImageConversionFlags flags = Qt::AutoColor)

将给定的image 中的矩形区域source 绘制到绘图设备中的target 矩形内。

void QPainter::drawImage(int x, int y, const QImage &image, int sx = 0, int sy = 0, int sw = -1, int sh = -1, Qt::ImageConversionFlags flags = Qt::AutoColor)

在坐标 (x,y) 处绘制图像，方法是将image 的一部分复制到绘图设备中。

(x,y) 指定要绘制在绘图设备上的左上角点。 (sx,sy) 指定要绘制的图像image 中的左上角点。默认值为 (0, 0)。

(sw,sh) 指定要绘制的图像的大小。默认值 (0, 0)（以及负数）表示绘制范围将延伸至图像的右下角。

void QPainter::drawLine(const QLineF &line)

绘制由line 定义的直线。

QLineF line(10.0, 80.0, 90.0, 20.0); QPainter painter(this); painter.drawLine(line);

另请参阅 drawLines()、drawPolyline()以及“坐标系”。

void QPainter::drawLine(const QLine &line)

绘制由line 定义的直线。

void QPainter::drawLine(const QPoint &p1, const QPoint &p2)

从p1 到p2 画一条线。

void QPainter::drawLine(const QPointF &p1, const QPointF &p2)

从p1 到p2 绘制一条直线。

void QPainter::drawLine(int x1, int y1, int x2, int y2)

绘制一条从 (x1,y1) 到 (x2,y2) 的直线。

void QPainter::drawLines(const QLineF *lines, int lineCount)

使用当前画笔在数组lines 中绘制前lineCount 条线。

另请参阅 drawLine() 和drawPolyline()。

void QPainter::drawLines(const QList<QLine> &lines)

使用当前的笔和画笔，绘制由列表lines 定义的一组直线。

void QPainter::drawLines(const QList<QLineF> &lines)

使用当前的笔和画笔，绘制由列表lines 定义的一组直线。

void QPainter::drawLines(const QList<QPoint> &pointPairs)

使用当前画笔，为向量pointPairs 中的每对点绘制一条线。

void QPainter::drawLines(const QList<QPointF> &pointPairs)

使用当前画笔，针对向量pointPairs 中的每一对点绘制一条直线。如果数组中的点数为奇数，则最后一个点将被忽略。

void QPainter::drawLines(const QLine *lines, int lineCount)

使用当前画笔，在数组lines 中绘制前lineCount 条线。

void QPainter::drawLines(const QPoint *pointPairs, int lineCount)

使用当前画笔，在数组pointPairs 中绘制前lineCount 条线。

void QPainter::drawLines(const QPointF *pointPairs, int lineCount)

使用当前画笔，在数组pointPairs 中绘制前lineCount 条线。这些线由点对指定，因此pointPairs 中的条目数必须至少为lineCount * 2。

void QPainter::drawPath(const QPainterPath &path)

使用当前的笔绘制轮廓，并使用当前的画笔进行填充，以绘制给定的画家path 。

QPainterPath path; path.moveTo(20, 80); path.lineTo(20, 30); path.cubicTo(80, 0, 50, 50, 80, 80); QPainter painter(this); painter.drawPath(path);

另请参阅 “Painter Paths”示例和“Vector Deformation”示例。

void QPainter::drawPicture(const QPointF &point, const QPicture &picture)

在指定的point 上重放给定的picture 。

QPicture 类是一种绘图设备，用于记录和重放QPainter 命令。Picture将绘图命令以一种与平台无关的格式序列化到IO设备中。凡是在小部件或像素图上可以绘制的内容，均可存储在Picture中。

当调用此函数时，若将point 设为QPointF(0, 0)，其行为与QPicture::play() 完全一致。

QPicture picture;
QPointF point(10.0, 20.0);
picture.load("drawing.pic");

QPainter painter(this);
painter.drawPicture(0, 0, picture);

另请参阅 QPicture::play()。

void QPainter::drawPicture(const QPoint &point, const QPicture &picture)

在指定的point 上重放给定的picture 。

void QPainter::drawPicture(int x, int y, const QPicture &picture)

在点 (x,y) 处绘制给定的picture 。

void QPainter::drawPie(const QRectF &rectangle, int startAngle, int spanAngle)

绘制一个由给定的rectangle 、startAngle 和spanAngle 定义的饼图。

该扇形将填充当前的brush()。

startAngle 和 spanAngle 必须以 1/16 度为单位指定，即一整圈等于 5760（16 × 360）。角度的正值表示逆时针方向，负值表示顺时针方向。 零度位于3点钟位置。如果rectangle 不是正方形，则这些角度为偏心角，并不表示从矩形中心出发的方向，具体说明请参见Arcs and Ellipses 。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); int startAngle = 30 * 16; int spanAngle = 120 * 16; QPainter painter(this); painter.drawPie(rectangle, startAngle, spanAngle);

另请参阅 drawEllipse()、drawChord() 以及“坐标系”。

void QPainter::drawPie(const QRect &rectangle, int startAngle, int spanAngle)

绘制由给定的rectangle 、startAngle 和spanAngle 定义的饼图。

void QPainter::drawPie(int x, int y, int width, int height, int startAngle, int spanAngle)

绘制由矩形（起始点为 (x,y)）所定义的扇形，其中width 和height 为指定值，startAngle 和spanAngle 为给定值。

void QPainter::drawPixmap(const QRectF &target, const QPixmap &pixmap, const QRectF &source)

将给定的pixmap 中的矩形区域source 绘制到绘图设备中给定的target 中。

QRectF target(10.0, 20.0, 80.0, 60.0);
QRectF source(0.0, 0.0, 70.0, 40.0);
QPixmap pixmap(":myPixmap.png");

QPainter painter(this);
painter.drawPixmap(target, pixmap, source);

如果pixmap 是QBitmap ，则使用画笔颜色绘制“设置”的位；如果backgroundMode 是Qt::OpaqueMode ，则使用背景画笔的颜色绘制“未设置”的位；如果backgroundMode 是Qt::TransparentMode ，则“未设置”的位为透明。不支持使用渐变色或纹理色绘制位图。

另请参阅 drawImage() 和QPixmap::devicePixelRatio()。

void QPainter::drawPixmap(const QPoint &point, const QPixmap &pixmap)

绘制给定的pixmap ，其原点位于给定的point 。

void QPainter::drawPixmap(const QPointF &point, const QPixmap &pixmap)

绘制给定的pixmap ，其原点位于给定的point 处。

void QPainter::drawPixmap(const QRect &rectangle, const QPixmap &pixmap)

将给定的pixmap 绘制到给定的rectangle 中。

void QPainter::drawPixmap(const QPoint &point, const QPixmap &pixmap, const QRect &source)

绘制给定矩形区域source ，该区域属于给定的pixmap ，其原点位于给定的point 。

void QPainter::drawPixmap(const QPointF &point, const QPixmap &pixmap, const QRectF &source)

绘制给定矩形区域source ，该区域属于给定矩形pixmap ，其原点位于给定坐标point 。

void QPainter::drawPixmap(const QRect &target, const QPixmap &pixmap, const QRect &source)

将给定的pixmap 中的矩形区域source 绘制到绘图设备中给定的target 中。

void QPainter::drawPixmap(int x, int y, const QPixmap &pixmap)

在位置 (x,y) 处绘制给定的pixmap 。

void QPainter::drawPixmap(int x, int y, int width, int height, const QPixmap &pixmap)

将pixmap 绘制到坐标为(x,y)的矩形中，并应用给定的width 和height 。

void QPainter::drawPixmap(int x, int y, const QPixmap &pixmap, int sx, int sy, int sw, int sh)

在坐标 (x,y) 处绘制一张位图，方法是将给定的pixmap 的一部分复制到绘图设备中。

(x,y) 指定要绘制的绘图设备中的左上角点。(sx,sy) 指定要绘制的pixmap 中的左上角点。默认值为 (0, 0)。

(sw,sh) 指定要绘制的像素图的大小。默认值 (0, 0)（以及负数）表示绘制范围一直延伸到像素图的右下角。

void QPainter::drawPixmap(int x, int y, int w, int h, const QPixmap &pixmap, int sx, int sy, int sw, int sh)

在坐标点 (sx,sy) 处，绘制给定像素图pixmap 的矩形部分，其宽度为sw ，高度为sh ，并以坐标点 (x,y) 为中心，宽度为w ，高度为h 。如果 sw 或 sh 等于零，则使用像素图的宽度/高度，并通过偏移量 sx/sy 进行调整；

void QPainter::drawPixmapFragments(const QPainter::PixmapFragment *fragments, int fragmentCount, const QPixmap &pixmap, QPainter::PixmapFragmentHints hints = PixmapFragmentHints())

该函数用于在多个位置以不同的缩放比例、旋转角度和不透明度绘制pixmap ，或pixmap 的子矩形。fragments 是一个由fragmentCount 元素组成的数组，用于指定绘制每个像素图片段所用的参数。hints 参数可用于传递绘制提示。

由于后端可以优化状态变更，因此该函数的速度可能比多次调用drawPixmap() 更快。

另请参阅 QPainter::PixmapFragment 和QPainter::PixmapFragmentHint 。

void QPainter::drawPoint(const QPointF &position)

使用当前画笔的颜色，在给定的position 坐标处绘制一个点。

另请参阅 “坐标系”。

void QPainter::drawPoint(const QPoint &position)

使用当前画笔的颜色，在给定的position 坐标处绘制一个点。

void QPainter::drawPoint(int x, int y)

在坐标 (x,y) 处绘制一个点。

void QPainter::drawPoints(const QPointF *points, int pointCount)

使用当前画笔的颜色，绘制数组points 中的前pointCount 个点。

另请参阅 “坐标系”。

void QPainter::drawPoints(const QPolygon &points)

绘制向量points 中的点。

void QPainter::drawPoints(const QPolygonF &points)

绘制向量points 中的点。

void QPainter::drawPoints(const QPoint *points, int pointCount)

使用当前画笔的颜色，绘制数组points 中的前pointCount 个点。

void QPainter::drawPolygon(const QPointF *points, int pointCount, Qt::FillRule fillRule = Qt::OddEvenFill)

使用当前的画笔和笔刷，绘制由数组points 中前pointCount 个点所定义的多边形。

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) }; QPainter painter(this); painter.drawPolygon(points, 4);

第一个点会隐式连接到最后一个点，且多边形将使用当前的brush()进行填充。

如果fillRule 为Qt::WindingFill ，则使用绕行填充算法对多边形进行填充。如果fillRule 为Qt::OddEvenFill ，则使用奇偶填充算法对多边形进行填充。有关这些填充规则的更详细说明，请参阅Qt::FillRule 。

另请参阅 drawConvexPolygon()、drawPolyline() 以及“坐标系”。

void QPainter::drawPolygon(const QPolygon &points, Qt::FillRule fillRule = Qt::OddEvenFill)

使用填充规则fillRule 绘制由给定的points 定义的多边形。

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

使用填充规则fillRule 绘制由给定的points 定义的多边形。

void QPainter::drawPolygon(const QPoint *points, int pointCount, Qt::FillRule fillRule = Qt::OddEvenFill)

绘制由数组points 中的前pointCount 个点所定义的多边形。

void QPainter::drawPolyline(const QPointF *points, int pointCount)

使用当前画笔，在points 中绘制由第一个pointCount 中的点定义的多线。

请注意，与drawPolygon()函数不同，最后一个点不会与第一个点相连，多线段也不会被填充。

static const QPointF points[3] = {
    QPointF(10.0, 80.0),
    QPointF(20.0, 10.0),
    QPointF(80.0, 30.0),
};

QPainter painter(this);
painter.drawPolyline(points, 3);

另请参阅 drawLines()、drawPolygon() 以及“坐标系”。

void QPainter::drawPolyline(const QPolygon &points)

使用当前画笔绘制由给定的points 定义的多段线。

void QPainter::drawPolyline(const QPolygonF &points)

使用当前画笔绘制由给定的points 定义的多线。

void QPainter::drawPolyline(const QPoint *points, int pointCount)

使用当前画笔，绘制由points 中前pointCount 个点定义的多段线。

void QPainter::drawRect(const QRectF &rectangle)

使用当前的笔和画笔绘制当前的rectangle 。

实心矩形的大小为rectangle 乘以size() 。带边框的矩形的大小为rectangle 乘以size() 加上笔宽。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); QPainter painter(this); painter.drawRect(rectangle);

另请参阅 drawRects()、drawPolygon()，以及“坐标系”。

void QPainter::drawRect(const QRect &rectangle)

使用当前的笔和画笔绘制当前的rectangle 。

void QPainter::drawRect(int x, int y, int width, int height)

绘制一个矩形，其左上角位于 (x,y)，并使用给定的width 和height 。

void QPainter::drawRects(const QRectF *rectangles, int rectCount)

使用当前的笔和画笔，绘制给定rectangles 的第一个rectCount 。

另请参阅 drawRect()。

void QPainter::drawRects(const QList<QRect> &rectangles)

使用当前的笔和画笔绘制给定的rectangles 。

void QPainter::drawRects(const QList<QRectF> &rectangles)

使用当前的笔和画笔绘制给定的rectangles 。

void QPainter::drawRects(const QRect *rectangles, int rectCount)

使用当前的笔和画笔，绘制给定坐标组（rectangles ）中的第一个点（rectCount ）。

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

绘制给定的矩形rect ，并使其圆角化。

参数xRadius 和yRadius 指定了定义圆角矩形各角的椭圆半径。当mode 为Qt::RelativeSize 时，xRadius 和yRadius 分别以矩形宽度和高度的一半为基准，以百分比形式指定，且值应在0.0到100.0之间。

填充矩形的大小为 rect。size() 。描边矩形的大小为 rect。size() 加上笔宽。

QRectF rectangle(10.0, 20.0, 80.0, 60.0); QPainter painter(this); painter.drawRoundedRect(rectangle, 20.0, 15.0);

另请参阅 drawRect() 和QPen 。

void QPainter::drawRoundedRect(const QRect &rect, qreal xRadius, qreal yRadius, Qt::SizeMode mode = Qt::AbsoluteSize)

绘制给定的矩形rect ，并使其圆角化。

void QPainter::drawRoundedRect(int x, int y, int w, int h, qreal xRadius, qreal yRadius, Qt::SizeMode mode = Qt::AbsoluteSize)

绘制给定的矩形：x 、y 、w 、h ，并使其圆角化。

void QPainter::drawStaticText(const QPointF &topLeftPosition, const QStaticText &staticText)

在指定的topLeftPosition 处绘制给定的staticText 。

文本将使用绘图器上设置的字体和变换进行绘制。如果绘图器上设置的字体和/或变换与初始化QStaticText 布局时使用的不同，则必须重新计算布局。请使用QStaticText::prepare()方法，使用后续绘制时将使用的字体和变换来初始化staticText 。

如果topLeftPosition 与staticText 初始化时或上次绘制时的状态不一致，那么在将文本转换到新位置时会产生轻微的开销。

另请参阅 QStaticText 。

void QPainter::drawStaticText(const QPoint &topLeftPosition, const QStaticText &staticText)

在坐标topLeftPosition 处绘制staticText 。

void QPainter::drawStaticText(int left, int top, const QStaticText &staticText)

在坐标left 和top 处绘制staticText 。

void QPainter::drawText(const QPointF &position, const QString &text)

使用当前定义的文本方向，从给定的position 位置开始绘制给定的text 。

该函数不处理换行符（\n ），因为它无法将文本拆分为多行，也无法显示换行符。若需绘制包含换行符的多行文本，或希望文本自动换行，请改用接受矩形参数的 QPainter::drawText() 重载函数。

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 setFont() 和setPen()。

void QPainter::drawText(const QPoint &position, const QString &text)

使用当前定义的文本方向，从指定的position 位置开始绘制给定的text 。

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 setFont() 和setPen()。

void QPainter::drawText(const QRectF &rectangle, const QString &text, const QTextOption &option = QTextOption())

在rectangle 中绘制给定的text ，并使用option 来控制其位置、方向和倾斜角度。option 中指定的选项将覆盖QPainter 对象本身设置的选项。

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 setFont() 和setPen()。

void QPainter::drawText(int x, int y, const QString &text)

使用绘图器当前定义的文本方向，在位置 (x,y) 处绘制给定的text 。

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 setFont() 和setPen()。

void QPainter::drawText(const QRect &rectangle, int flags, const QString &text, QRect *boundingRect = nullptr)

根据指定的flags ，在给定的rectangle 内绘制text 。

boundingRect （若不为空）用于设定边界矩形，使其能够完全包围整个文本。例如，在下图中，虚线代表由该函数计算得到的boundingRect ，而点划线代表rectangle ：

QPainter painter(this); QFont font = painter.font(); font.setPixelSize(48); painter.setFont(font); const QRect rectangle = QRect(0, 0, 100, 50); QRect boundingRect; painter.drawText(rectangle, 0, tr("Hello"), &boundingRect); QPen pen = painter.pen(); pen.setStyle(Qt::DotLine); painter.setPen(pen); painter.drawRect(boundingRect.adjusted(0, 0, -pen.width(), -pen.width())); pen.setStyle(Qt::DashLine); painter.setPen(pen); painter.drawRect(rectangle.adjusted(0, 0, -pen.width(), -pen.width()));

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 setFont() 和setPen()。

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

在指定的rectangle 内绘制给定的text 。rectangle 与对齐方式flags 共同定义了text 的锚点。

QPainter painter(this); painter.drawText(rect, Qt::AlignCenter, tr("Qt\nProject"));

boundingRect （若不为空）用于指定边界矩形应具备的尺寸，以便将整个文本完全包含其中。例如，在下图中，虚线代表由该函数计算得到的boundingRect ，而点线则代表rectangle ：

QPainter painter(this); QFont font = painter.font(); font.setPixelSize(48); painter.setFont(font); const QRect rectangle = QRect(0, 0, 100, 50); QRect boundingRect; painter.drawText(rectangle, 0, tr("Hello"), &boundingRect); QPen pen = painter.pen(); pen.setStyle(Qt::DotLine); painter.setPen(pen); painter.drawRect(boundingRect.adjusted(0, 0, -pen.width(), -pen.width())); pen.setStyle(Qt::DashLine); painter.setPen(pen); painter.drawRect(rectangle.adjusted(0, 0, -pen.width(), -pen.width()));

flags 参数是以下标志的按位或运算结果：

• Qt::AlignLeft
• Qt::AlignRight
• Qt::AlignHCenter
• Qt::AlignJustify
• Qt::AlignTop
• Qt::AlignBottom
• Qt::AlignVCenter
• Qt::AlignCenter
• Qt::TextDontClip
• Qt::TextSingleLine
• Qt::TextExpandTabs
• Qt::TextShowMnemonic
• Qt::TextWordWrap
• Qt::TextIncludeTrailingSpaces

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 Qt::AlignmentFlag 、Qt::TextFlag 、boundingRect() 以及layoutDirection()。

void QPainter::drawText(int x, int y, int width, int height, int flags, const QString &text, QRect *boundingRect = nullptr)

在以 (x,y) 为原点、width 和height 为边长的矩形内绘制给定的text 。

boundingRect （若不为空）用于定义边界矩形，该矩形应能够完全包围整个文本。例如，在下图中，虚线代表由该函数计算得到的boundingRect ，而点划线代表由x 、y 、width 和height 定义的矩形：

QPainter painter(this); QFont font = painter.font(); font.setPixelSize(48); painter.setFont(font); const QRect rectangle = QRect(0, 0, 100, 50); QRect boundingRect; painter.drawText(rectangle, 0, tr("Hello"), &boundingRect); QPen pen = painter.pen(); pen.setStyle(Qt::DotLine); painter.setPen(pen); painter.drawRect(boundingRect.adjusted(0, 0, -pen.width(), -pen.width())); pen.setStyle(Qt::DashLine); painter.setPen(pen); painter.drawRect(rectangle.adjusted(0, 0, -pen.width(), -pen.width()));

flags 参数是以下标志位的按位或运算结果：

• Qt::AlignLeft
• Qt::AlignRight
• Qt::AlignHCenter
• Qt::AlignJustify
• Qt::AlignTop
• Qt::AlignBottom
• Qt::AlignVCenter
• Qt::AlignCenter
• Qt::TextSingleLine
• Qt::TextExpandTabs
• Qt::TextShowMnemonic
• Qt::TextWordWrap

默认情况下，QPainter 会以抗锯齿方式绘制文本。

另请参阅 Qt::AlignmentFlag 、Qt::TextFlag 、setFont() 以及setPen()。

void QPainter::drawTiledPixmap(const QRectF &rectangle, const QPixmap &pixmap, const QPointF &position = QPointF())

在给定的rectangle 内，以给定的position 为原点，绘制一个平铺的pixmap 。

调用 drawTiledPixmap() 的效果类似于多次调用drawPixmap() 来用位图填充（平铺）一个区域，但根据底层窗口系统的不同，其效率可能要高得多。

与普通 dpi 显示器相比，drawTiledPixmap() 在高 dpi 显示器（devicePixelRatio > 1）上将生成相同的视觉平铺图案。 通过设置pixmap 上的 devicePixelRatio 来控制拼贴块的大小。例如，将其设置为 2 会将拼贴块的宽度和高度减半（在 1x 和 2x 显示器上均如此），并在 2x 显示器上生成高分辨率输出。

position 的偏移量以与rectangle 左上角相对的设备独立像素为单位提供。可通过position 将重复图案对齐到rectangle 内部。

另请参阅 drawPixmap()。

void QPainter::drawTiledPixmap(const QRect &rectangle, const QPixmap &pixmap, const QPoint &position = QPoint())

在给定的rectangle 内绘制一个平铺的pixmap ，其原点位于给定的position 处。

void QPainter::drawTiledPixmap(int x, int y, int width, int height, const QPixmap &pixmap, int sx = 0, int sy = 0)

在指定的矩形内绘制一个平铺的pixmap 。

(x,y) 指定要在绘图设备上进行绘制的左上角点；其中width 和height 已给定。

(sx,sy) 指定了将在指定矩形内绘制位图的原点。原点位置以设备独立像素为单位，相对于 (x,y) 指定。默认值为 (0, 0)。

bool QPainter::end()

结束绘制。绘制过程中使用的所有资源均被释放。通常无需调用此方法，因为它会由析构函数自动调用。

如果绘制器不再处于活动状态，则返回true ；否则返回false 。

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

void QPainter::endNativePainting()

在手动发出原生绘制命令后，恢复绘图器的状态。允许绘图器在调用任何其他绘图命令之前，恢复其所依赖的任何原生状态。

另请参阅 beginNativePainting()。

void QPainter::eraseRect(const QRectF &rectangle)

清除给定rectangle 内部的区域。相当于调用

fillRect(rectangle, background());

另请参阅 fillRect()。

void QPainter::eraseRect(const QRect &rectangle)

清除给定rectangle 内部的区域。

void QPainter::eraseRect(int x, int y, int width, int height)

清除以(x,y)为起点的矩形内部区域，并应用给定的width 和height 。

void QPainter::fillPath(const QPainterPath &path, const QBrush &brush)

使用给定的brush 填充给定的path 。不绘制轮廓。

此外，您也可以指定一个QColor 代替QBrush ；QBrush 构造函数（接受QColor 参数）将自动创建一个实心图案画笔。

另请参阅 drawPath()。

void QPainter::fillRect(const QRectF &rectangle, const QBrush &brush)

将指定的brush 填充到给定的rectangle 中。

此外，您也可以指定一个QColor 来代替QBrush ；QBrush 构造函数（接受QColor 参数）将自动创建一个实心图案画笔。

另请参阅 drawRect()。

void QPainter::fillRect(const QRect &rectangle, QGradient::Preset preset)

将给定的rectangle 填充为指定的渐变preset 。

void QPainter::fillRect(const QRect &rectangle, Qt::BrushStyle style)

使用指定的画笔style 填充给定的rectangle 。

void QPainter::fillRect(const QRect &rectangle, Qt::GlobalColor color)

将给定的rectangle 填充为指定的color 。

void QPainter::fillRect(const QRect &rectangle, const QBrush &brush)

将给定的rectangle 填充为指定的brush 。

void QPainter::fillRect(const QRect &rectangle, const QColor &color)

将指定的rectangle 填充为指定的color 。

void QPainter::fillRect(const QRectF &rectangle, QGradient::Preset preset)

将给定的rectangle 填充为指定的渐变preset 。

void QPainter::fillRect(const QRectF &rectangle, Qt::BrushStyle style)

使用指定的画笔style 填充给定的rectangle 。

void QPainter::fillRect(const QRectF &rectangle, Qt::GlobalColor color)

将给定的rectangle 填充为指定的color 。

void QPainter::fillRect(const QRectF &rectangle, const QColor &color)

将指定的rectangle 填充为color 。

void QPainter::fillRect(int x, int y, int width, int height, QGradient::Preset preset)

使用给定的渐变色preset ，将起始于(x,y)的矩形填充为给定的width 和height 。

void QPainter::fillRect(int x, int y, int width, int height, Qt::BrushStyle style)

使用指定的画笔style ，将起始于(x,y)的矩形填充为给定的width 和height 。

void QPainter::fillRect(int x, int y, int width, int height, Qt::GlobalColor color)

使用给定的color ，将起始于(x,y)的矩形填充为给定的width 和height 。

void QPainter::fillRect(int x, int y, int width, int height, const QBrush &brush)

使用给定的brush ，将以(x,y)为起点的矩形填充为给定的width 和height 。

void QPainter::fillRect(int x, int y, int width, int height, const QColor &color)

使用给定的color ，将以(x,y)为起点的矩形填充为给定的width 和height 。

const QFont &QPainter::font() const

返回当前用于绘制文本的已设置字体。

另请参阅 setFont()、drawText()，以及Settings 。

QFontInfo QPainter::fontInfo() const

如果绘图器处于活动状态，则返回该绘图器的字体信息。否则，返回值未定义。

另请参阅 font(),isActive() 以及Settings 。

QFontMetrics QPainter::fontMetrics() const

如果绘图器处于活动状态，则返回该绘图器的字体度量数据。否则，返回值未定义。

另请参阅 font()、isActive() 以及Settings 。

bool QPainter::hasClipping() const

如果已设置裁剪，则返回true ；否则返回false 。

另请参见 setClipping() 和Clipping 。

bool QPainter::isActive() const

如果已调用begin()，但尚未调用end()，则返回true ；否则返回false 。

另请参阅 begin() 和QPaintDevice::paintingActive()。

Qt::LayoutDirection QPainter::layoutDirection() const

返回绘图器在绘制文本时使用的布局方向。

另请参阅 QTextOption::textDirection()、setLayoutDirection()、drawText() 以及Settings 。

qreal QPainter::opacity() const

返回画笔的不透明度。默认值为 1。

另请参阅 ` setOpacity()`。

QPaintEngine *QPainter::paintEngine() const

如果绘制器处于活动状态，则返回绘制器当前正在操作的绘制引擎；否则返回 0。

另请参阅 isActive()。

const QPen &QPainter::pen() const

返回画师当前的画笔。

另请参阅 setPen() 和Settings 。

QPainter::RenderHints QPainter::renderHints() const

返回一个标志，用于指定为该绘制器设置的渲染提示。

另请参阅 setRenderHints()、testRenderHint() 以及Rendering Quality 。

void QPainter::resetTransform()

重置使用translate()、scale()、shear()、rotate()、setWorldTransform()、setViewport() 和setWindow() 进行的任何变换。

另请参阅 Coordinate Transformations 。

void QPainter::restore()

恢复当前绘图器的状态（从栈中弹出一个已保存的状态）。

另请参阅 save()。

void QPainter::rotate(qreal angle)

将坐标系顺时针旋转。给定的angle 参数以度为单位。

另请参阅 setWorldTransform() 和Coordinate Transformations 。

void QPainter::save()

保存当前绘制器的状态（将状态压入栈中）。调用 save() 后必须跟上相应的restore(); 函数end() 用于从栈中弹出状态。

另请参阅 restore()。

void QPainter::scale(qreal sx, qreal sy)

按 (sx,sy) 缩放坐标系。

另请参阅 setWorldTransform() 和Coordinate Transformations 。

void QPainter::setBackground(const QBrush &brush)

将绘图工具的背景画笔设置为指定的brush 。

背景画笔是在绘制不透明文本、点画线和位图时用于填充的画笔。在透明背景模式下（这是默认设置），背景画笔不产生任何效果。

另请参阅 background()、setBackgroundMode() 和Settings 。

void QPainter::setBackgroundMode(Qt::BGMode mode)

将绘图器的背景模式设置为指定的mode

Qt::TransparentMode （默认）会绘制点状线条和文本，而不设置背景像素。Qt::OpaqueMode 会用当前背景色填充这些区域。

请注意，若要以透明方式绘制位图或像素图，必须使用QPixmap::setMask()。

另请参阅 backgroundMode()、setBackground() 和Settings 。

void QPainter::setBrush(const QBrush &brush)

将绘图工具的画笔设置为指定的brush 。

画笔决定了形状的填充方式。

另请参阅 brush()和Settings 。

[since 6.11] void QPainter::setBrush(QBrush &&brush)

该函数在 Qt 6.11 中引入。

[since 6.9] void QPainter::setBrush(QColor color)

将画家的画笔设置为带有指定color 的实心画笔。

该函数在 Qt 6.9 中引入。

void QPainter::setBrush(Qt::BrushStyle style)

将画笔颜色设置为黑色，并将画笔的style 属性设置为指定值。

[since 6.9] void QPainter::setBrush(Qt::GlobalColor color)

将画家的画笔设置为带指定color 的实心画笔。

该函数在 Qt 6.9 中引入。

void QPainter::setBrushOrigin(const QPointF &position)

将画笔原点设置为position 。

画笔原点指定了绘图器的画笔的 (0, 0) 坐标。

请注意，虽然在 Qt 3 中必须调用brushOrigin() 才能使小部件采用父窗口的背景，但在 Qt 4 中情况已不再如此，因为 Qt 4 的绘图器不会绘制背景，除非您通过将小部件的autoFillBackground 属性设置为 true 来明确指示其执行此操作。

另请参阅 brushOrigin() 和Settings 。

void QPainter::setBrushOrigin(const QPoint &position)

将画笔的原点设置为给定的position 。

void QPainter::setBrushOrigin(int x, int y)

将画笔的原点设置为点 (x,y)。

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

启用裁剪功能，并将绘图工具的裁剪路径设置为给定的path ，裁剪operation 。

请注意，裁剪路径是以逻辑（绘图器）坐标指定的。

另请参阅 clipPath()、clipRegion() 以及Clipping 。

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

启用裁剪功能，并使用给定的裁剪矩形坐标（clipoperation ）将裁剪区域设置为给定的rectangle 。默认操作是替换当前的裁剪矩形。

请注意，剪切矩形使用逻辑（绘图）坐标进行指定。

另请参阅 clipRegion()、setClipping() 以及Clipping 。

void QPainter::setClipRect(int x, int y, int width, int height, Qt::ClipOperation operation = Qt::ReplaceClip)

启用裁剪功能，并将裁剪区域设置为以 (x,y) 为起点的矩形，同时使用给定的width 和height 。

void QPainter::setClipRect(const QRect &rectangle, Qt::ClipOperation operation = Qt::ReplaceClip)

启用裁剪功能，并使用给定的裁剪区域坐标（clipoperation ）将裁剪区域设置为给定的裁剪区域坐标（rectangle ）。

void QPainter::setClipRegion(const QRegion &region, Qt::ClipOperation operation = Qt::ReplaceClip)

使用指定的剪切操作operation 将剪切区域设置为给定的region 。默认的剪切操作是替换当前的剪切区域。

请注意，剪切区域使用逻辑坐标表示。

另请参阅 clipRegion()、setClipRect() 以及Clipping 。

void QPainter::setClipping(bool enable)

如果enable 为 true，则启用剪切；如果enable 为 false，则禁用剪切。

另请参阅 hasClipping() 和Clipping 。

void QPainter::setCompositionMode(QPainter::CompositionMode mode)

将合成模式设置为给定的mode 。

另请参阅 compositionMode()。

void QPainter::setFont(const QFont &font)

将绘图工具的字体设置为指定的font 。

后续调用的drawText()函数将使用此字体。文本颜色与画笔颜色相同。

如果设置的字体不可用，Qt会自动寻找最接近的字体。font()将返回通过setFont()设置的字体，而fontInfo()则返回实际使用的字体（两者可能相同）。

另请参阅 font()、drawText() 以及Settings 。

void QPainter::setLayoutDirection(Qt::LayoutDirection direction)

将绘图器在绘制文本时使用的布局方向设置为指定的direction 。

默认值为Qt::LayoutDirectionAuto ，该值将根据绘制的文本隐式确定方向。

另请参阅 QTextOption::setTextDirection()、layoutDirection()、drawText() 以及Settings 。

void QPainter::setOpacity(qreal opacity)

将绘图工具的不透明度设置为opacity 。该值应在0.0到1.0之间，其中0.0表示完全透明，1.0表示完全不透明。

在绘图工具上设置的不透明度将分别应用于每次绘图操作。填充形状和绘制其轮廓被视为独立的绘图操作。

另请参阅 opacity()。

void QPainter::setPen(const QPen &pen)

将绘图笔设置为指定的pen 。

pen 定义了如何绘制线条和轮廓，同时也定义了文本颜色。

另请参阅 pen()和Settings 。

[since 6.11] void QPainter::setPen(QPen &&pen)

该函数在 Qt 6.11 中引入。

void QPainter::setPen(Qt::PenStyle style)

将画笔设置为具有给定的style 、宽度为1以及黑色。

void QPainter::setPen(const QColor &color)

将画笔设置为样式Qt::SolidLine 、宽度1以及指定的color 。

void QPainter::setRenderHint(QPainter::RenderHint hint, bool on = true)

如果 `on ` 为真，则将给定的渲染提示 `hint ` 设置到绘图器上；否则清除该渲染提示。

另请参阅 setRenderHints()、renderHints() 以及Rendering Quality 。

void QPainter::setRenderHints(QPainter::RenderHints hints, bool on = true)

如果 `on ` 为真，则将给定的渲染提示 `hints ` 设置到绘图器上；否则清除渲染提示。

另请参阅 setRenderHint()、renderHints() 以及Rendering Quality 。

void QPainter::setTransform(const QTransform &transform, bool combine = false)

设置世界变换矩阵。如果combine 为真，则将指定的transform 与当前矩阵进行组合；否则，它将替换当前矩阵。

另请参阅 transform() 和setWorldTransform()。

void QPainter::setViewTransformEnabled(bool enable)

如果 `enable ` 为真，则启用视图变换；如果 `enable ` 为假，则禁用视图变换。

另请参阅 viewTransformEnabled() 和窗口-视口转换。

void QPainter::setViewport(const QRect &rectangle)

将绘图器的视口矩形设置为给定的rectangle ，并启用视图变换。

视口矩形是视图变换的一部分。视口定义了设备坐标系，而与其对应的window()则定义了逻辑坐标系。

默认视口矩形与设备的矩形相同。

另请参阅 viewport()、viewTransformEnabled() 以及“窗口-视口转换”。

void QPainter::setViewport(int x, int y, int width, int height)

将绘图器的视口矩形设置为以 (x,y) 为起点的矩形，并使用给定的width 和height 。

void QPainter::setWindow(const QRect &rectangle)

将绘图窗口设置为给定的rectangle ，并启用视图变换。

窗口矩形是视图变换的一部分。窗口指定逻辑坐标系，而与其对应的viewport()则指定设备坐标系。

默认窗口矩形与设备矩形相同。

另请参阅 window()、viewTransformEnabled() 以及“窗口-视口转换”。

void QPainter::setWindow(int x, int y, int width, int height)

将绘图器的窗口设置为以 (x,y) 为起点的矩形，并使用给定的width 和height 。

void QPainter::setWorldMatrixEnabled(bool enable)

如果enable 为真，则启用变换；如果enable 为假，则禁用变换。世界变换矩阵保持不变。

另请参阅 worldMatrixEnabled()、worldTransform() 以及Coordinate Transformations 。

void QPainter::setWorldTransform(const QTransform &matrix, bool combine = false)

设置世界变换矩阵。如果combine 为真，则指定的matrix 将与当前矩阵合并；否则，它将替换当前矩阵。

另请参阅 worldTransform()、transform() 和setTransform()。

void QPainter::shear(qreal sh, qreal sv)

将坐标系进行剪切，剪切参数为 (sh,sv)。

另请参阅 setWorldTransform() 和Coordinate Transformations 。

void QPainter::strokePath(const QPainterPath &path, const QPen &pen)

path 使用由pen

另请参阅 fillPath() 和Drawing 。

bool QPainter::testRenderHint(QPainter::RenderHint hint) const

如果已设置 `hint `，则返回 `true `；否则返回 `false`。

另请参阅 renderHints() 和setRenderHint()。

const QTransform &QPainter::transform() const

worldTransform() 的别名。返回世界变换矩阵。

另请参阅 setTransform() 和worldTransform()。

void QPainter::translate(const QPointF &offset)

将坐标系按给定的offset 进行平移；即，将给定的offset 加到各点上。

另请参阅 setWorldTransform() 和Coordinate Transformations 。

void QPainter::translate(const QPoint &offset)

将坐标系沿给定的offset 进行平移。

void QPainter::translate(qreal dx, qreal dy)

将坐标系沿向量 (dx,dy) 进行平移。

bool QPainter::viewTransformEnabled() const

如果启用了视图变换，则返回true ；否则返回false。

另请参阅 setViewTransformEnabled() 和worldTransform()。

QRect QPainter::viewport() const

返回视口矩形。

另请参阅 setViewport() 和setViewTransformEnabled()。

QRect QPainter::window() const

返回窗口矩形。

另请参阅 setWindow() 和setViewTransformEnabled()。

bool QPainter::worldMatrixEnabled() const

如果启用了世界变换，则返回true ；否则返回false。

另请参阅 setWorldMatrixEnabled()、worldTransform() 以及“坐标系”。

const QTransform &QPainter::worldTransform() const

返回世界变换矩阵。

另请参阅 setWorldTransform()。