QPainter类

成员函数文档

QPainter::QPainter()

构造一个画家。

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

[显式] QPainter::QPainter(QPaintDevice *device)

constructs一个画家，立即开始在画布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() 和 设置。

Qt::BGMode QPainter::backgroundMode() const

返回当前背景模式。

另请参阅 setBackgroundMode() 和 设置。

bool QPainter::begin(QPaintDevice *device)

开始在画布device上绘画，如果成功则返回true；否则返回false。

注意，调用begin()时，所有画家设置（如setPen()、setBrush()等）都会重置为默认值。

可能发生的错误是严重的问题，例如这些

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

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)

返回文本的边界矩形，该文本将在使用当前设置的 字体，以及在给定的 rectangle 内以指定的 flags 绘制时的外观；即该函数告诉您，当给定相同的参数时，drawText() 函数将绘制在哪里。

如果使用指定的 flags 将文本放入给定的 rectangle 中，则该函数返回所需的矩形。

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

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

这是一个重载函数。

返回文本的边界矩形，该文本将在使用当前设置的 字体，以及在给定的 rectangle 内以指定的 flags 绘制时的外观。

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

这是一个重载函数。

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

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

这是一个重载函数。

而不是将标志作为 Qt::AlignmentFlag 和 Qt::TextFlag 的按位或运算结果，这个重载函数接受一个 option 参数。QTextOption 类提供了一个关于通用富文本属性的描述。

请参阅QTextOption。

const QBrush &QPainter::brush() const

返回画笔的当前刷子。

另请参阅 QPainter::setBrush() 以及 设置.

QPoint QPainter::brushOrigin() const

返回当前设置的画笔原点。

另请参阅 setBrushOrigin() 以及 设置.

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

返回当前组合模式。

另请参阅 组合模式 以及 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）。角度的正值表示逆时针方向，负值表示顺时针方向。0度在3点位置。

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)

这是一个重载函数。

以指定width和height以及给定的startAngle和spanAngle开始绘制由矩形rectangle定义的圆弧。

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

根据给定的rectangle、startAngle和spanAngle绘制弦，弦用当前刷子填充。

startAngle和spanAngle必须以1/16度为单位指定，即完整圆等于5760（16 * 360）。角度的正值表示逆时针方向，负值表示顺时针方向。0度在3点位置。

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(int x, int y, int width, int height, int startAngle, int spanAngle)

这是一个重载函数。

以指定width和height以及给定的startAngle和spanAngle开始绘制由矩形rectangle定义的弦。

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

这是一个重载函数。

根据给定的rectangle、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);

第一个点隐式连接到最后一个点，并且多边形用当前刷子填充。如果提供的多边形不是凸的，即它包含至少一个大于180度的角，则结果未定义。

在某些平台（例如X11）上，drawConvexPolygon()函数可能比drawPolygon()函数更快。

另请参阅 drawPolygon()，drawPolyline() 和 坐标系.

void QPainter::drawConvexPolygon(const QPolygonF &polygon)

这是一个重载函数。

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

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

这是一个重载函数。

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

void QPainter::drawConvexPolygon(const QPolygon &polygon)

这是一个重载函数。

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

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(int x, int y, int width, int height)

这是一个重载函数。

绘制从(x，y)开始，有给定 width 和 height 的矩形定义的椭圆。

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

这是一个重载函数。

绘制位于 center，半径为 rx 和 ry 的椭圆。

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

这是一个重载函数。

绘制位于 center，半径为 rx 和 ry 的椭圆。

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

在 position 位置绘制由 glyphs 表示的符号。 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)

将指定图像的矩形片段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 QRect &target, const QImage &image, const QRect &source, Qt::ImageConversionFlags flags = Qt::AutoColor)

这是一个重载函数。

将指定图像的矩形片段source绘制到绘图设备中的目标矩形target。

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

这是一个重载函数。

以给定的point为原点绘制给定图像的矩形片段source。

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

这是一个重载函数。

以给定的point为原点绘制给定图像的矩形片段source。

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

这是一个重载函数。

将指定图像绘制到指定的rectangle。

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

这是一个重载函数。

将指定图像绘制到指定的rectangle。

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

这是一个重载函数。

将给定图像绘制到给定point处。

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

这是一个重载函数。

将给定图像绘制到给定point处。

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）处通过将图像的一部分复制到画布中来绘制图像。

(x, y)指定了要绘制到画布中的左上角点。（sx, sy）指定了要绘制到图像中的左上角点。默认为（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(int x1, int y1, int x2, int y2)

这是一个重载函数。

从（x1, y1）绘制到（x2, y2）的一线。

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

这是一个重载函数。

从p1到p2绘制一线。

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

这是一个重载函数。

从p1到p2绘制一线。

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

使用当前笔触绘制数组lines中的前lineCount条线。

另请参阅drawLine()和drawPolyline。

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

这是一个重载函数。

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

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

这是一个重载函数。

使用当前笔触绘制数组pointPairs中的前lineCount条线。线由点对指定，因此pointPairs中的条目数必须是lineCount * 2。

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

这是一个重载函数。

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

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

这是一个重载函数。

使用当前笔触绘制数组lines中的前lineCount条线。

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

使用当前画笔在每个输入向量 pointPairs 的点对中绘制一条线。

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

另请参阅绘图路径示例和矢量变形示例。

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

在给定的 point 上回放给定的 picture。

QPicture 类是一个记录和回放 QPainter 命令的绘图设备。一个图片将画笔命令序列化到一个平台无关的IO设备中。可以在小部件或位图上绘制的所有内容也可以存储在图片中。

当调用 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(int x, int y, const QPicture &picture)

这是一个重载函数。

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

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

这是一个重载函数。

在给定的 point 上回放给定的 picture。

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

使用指定的矩形、起始角度和跨角度绘制饼图。

饼图使用当前 画刷 填充。

startAngle和spanAngle必须以1/16度为单位指定，即完整圆等于5760（16 * 360）。角度的正值表示逆时针方向，负值表示顺时针方向。0度在3点位置。

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(int x, int y, int width, int height, int startAngle, int spanAngle)

这是一个重载函数。

绘制以起始坐标 (x, y) 为起点，具有指定 width 和 height 的矩形，以及给定 startAngle 和 spanAngle 的饼图。

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

这是一个重载函数。

使用给定的 rectangle，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 QRect &target, const QPixmap &pixmap, const QRect &source)

这是一个重载函数。

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

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

这是一个重载函数。

绘制以原点（sx，sy）为起点，宽sw和高度sh的矩形部分，在给定的pixmap中，在点（x，y）处，宽w和高度h。如果sw或sh等于零，则使用和调整pixmap的宽度和高度sx/sy；

void QPainter::drawPixmap（int x，int y，const QPixmap &pixmap，int sx，int sy，int sw，int sh）

这是一个重载函数。

通过拷贝给定pixmap的一部分到绘图设备，在（x，y）处绘制pixmap。

（x，y）指定绘图设备中将被绘制到的左上点。（sx，sy）指定要绘制的pixmap中的左上点。默认为（0，0）。

（sw，sh）指定要绘制的pixmap的大小。默认值（0，0）（以及负值）表示从左上角到底右角。

void QPainter::drawPixmap（const QPointF &point，const QPixmap &pixmap，const QRectF &source）

这是一个重载函数。

在给定的point处绘制给定pixmap的矩形部分source。

void QPainter::drawPixmap（const QPoint &point，const QPixmap &pixmap，const QRect &source）

这是一个重载函数。

在给定的point处绘制给定pixmap的矩形部分source。

void QPainter::drawPixmap（const QPointF &point，const QPixmap &pixmap）

这是一个重载函数。

在给定的point处绘制给定的pixmap。

void QPainter::drawPixmap（const QPoint &point，const QPixmap &pixmap）

这是一个重载函数。

在给定的point处绘制给定的pixmap。

void QPainter::drawPixmap（int x，int y，const QPixmap &pixmap）

这是一个重载函数。

在位置（x，y）处绘制给定的pixmap。

void QPainter::drawPixmap（const QRect &rectangle，const QPixmap &pixmap）

这是一个重载函数。

在给定的rectangle中绘制给定的pixmap。

void QPainter::drawPixmap（int x，int y，int width，int height，const QPixmap &pixmap）

这是一个重载函数。

将绘制到位置（x，y）的矩形中，有给定的宽度width和高度height。

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

此函数用于在多个位置以不同的缩放、旋转和透明度绘制 pixmap 或 pixmap 的子矩形。fragments 是一个包含 fragmentCount 个元素的数组，用于指定绘制每个 pixmap 片段的参数。《i translate="no">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 QPolygonF &points)

这是一个重载函数。

绘制向量 points 中的点。

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

这是一个重载函数。

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

void QPainter::drawPoints(const QPolygon &points)

这是一个重载函数。

绘制向量 points 中的点。

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

第一个点默认连接到最后一个点，多边形使用当前 刷 填充。

如果 fillRule 是 Qt::WindingFill，则使用环绕填充算法填充多边形。如果 fillRule 是 Qt::OddEvenFill，则使用奇偶填充算法填充多边形。有关这些填充规则的更详细描述，请参阅 Qt::FillRule。

另请参阅 drawConvexPolygon()，drawPolyline() 和 坐标系。

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::drawPolygon(const QPolygon &points，Qt::FillRule fillRule = Qt::OddEvenFill)

这是一个重载函数。

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

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 QPolygonF &points)

这是一个重载函数。

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

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

这是一个重载函数。

使用当前笔绘制由 points 中前 pointCount 个点定义的折线。

void QPainter::drawPolyline(const QPolygon &points)

这是一个重载函数。

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

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(int x，int y，int width，int height)

这是一个重载函数。

绘制一个矩形，其左上角在 (x，y)，给定 width 和 height。

void QPainter::drawRect(const QRect &rectangle)

这是一个重载函数。

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

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

使用当前笔刷和笔绘制给定的 rectangles 的前 rectCount 个。

另请参阅 drawRect。

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

这是一个重载函数。

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

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

这是一个重载函数。

使用当前笔刷和笔绘制给定的 rectangles 的前 rectCount 个。

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

这是一个重载函数。

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

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

绘制具有圆角的矩形rect。

xRadius和yRadius参数指定定义圆角矩形角的椭圆的半径。当mode是Qt::RelativeSize时，xRadius和yRadius分别以矩形宽度和高度的 halves 的百分比指定，应在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(int x, int y, int w, int h, qreal xRadius, qreal yRadius, Qt::SizeMode mode = Qt::AbsoluteSize)

这是一个重载函数。

绘制具有圆角的矩形x，y，w，h。

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

这是一个重载函数。

绘制具有圆角的矩形rect。

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(int x, int y, const QString &text)

这是一个重载函数。

使用画家当前定义的文字方向在位置 (x, y) 处绘制给定的 text。

默认情况下，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(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(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::drawText(const QRectF &rectangle, const QString &text, const QTextOption &option = QTextOption())

这是一个重载函数。

使用 option 控制文本的位置、方向和朝向，在指定的 rectangle 中绘制给定的 text。在 option 中给出的选项将覆盖 QPainter 对象本身上设置的选项。

默认情况下，QPainter 使用反走样方式绘制文本。

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

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

在其原点为给定点 position 的给定 rectangle 内绘制平铺的 pixmap。

调用 drawTiledPixmap() 与多次调用 drawPixmap() 填充 (平铺) 一个区域大致相同，但根据底层窗口系统，可能更高效。

在具有 (devicePixelRatio > 1) 的高 dpi 显示器上，drawTiledPixmap() 将产生与正常 dpi 显示器相同的视觉平铺模式。将 pixmap 上的 devicePixelRatio 设置为控制平铺大小。例如，将其设置为 2 则将平铺宽度和高度（在 1x 和 2x 显示器上）减半，并在 2x 显示器上产生高分辨率输出。

position 偏移量始终在画家坐标系中，而不依赖于显示设备PixelRatio。

另请参阅 drawPixmap()。

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) 指定了

pixmap

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

这是一个重载函数。

在其原点为给定点 position 的给定 rectangle 内绘制平铺的 pixmap。

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(int x, int y, int width, int height)

这是一个重载函数。

擦除从 (x, y) 开始，具有给定 width 和 height 的矩形内的区域。

void QPainter::eraseRect(const QRect &rectangle)

这是一个重载函数。

擦除给定rectangle区域内的区域。

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

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

或者，您可以指定一个 QColor 而不是 QBrush；带有 QColor 参数的 QBrush 构造函数将自动创建一个纯色图案画刷。

另请参阅 drawPath()。

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

使用指定的brush填充给定的rectangle。

或者，您可以指定一个 QColor 而不是 QBrush；带有 QColor 参数的 QBrush 构造函数将自动创建一个纯色图案画刷。

另请参阅 drawRect。

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

这是一个重载函数。

使用给定的 brush 填充以 x 和 y 为起始点的矩形，宽度为 width，高度为 height。

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

这是一个重载函数。

使用指定的 brush 填充给定的 rectangle。

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

这是一个重载函数。

使用指定的 color 填充给定的 rectangle。

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

这是一个重载函数。

使用给定的 color 填充以 x 和 y 为起始点的矩形，宽度为 width，高度为 height。

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

这是一个重载函数。

使用指定的 color 填充给定的 rectangle。

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

这是一个重载函数。

使用给定的 color 填充以 x 和 y 为起始点的矩形，宽度为 width，高度为 height。

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

这是一个重载函数。

使用指定的 color 填充给定的 rectangle。

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

这是一个重载函数。

使用指定的 color 填充给定的 rectangle。

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

这是一个重载函数。

使用给定的 brush style 填充以 x 和 y 为起始点的矩形，宽度为 width，高度为 height。

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

这是一个重载函数。

使用指定的 brush style 填充给定的 rectangle。

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

这是一个重载函数。

使用指定的 brush style 填充给定的 rectangle。

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

这是一个重载函数。

使用给定的 宽度 和 高度，以给定的渐变 预置 填充以 (x, y) 为起始点的矩形。

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

这是一个重载函数。

使用指定的渐变 预置 填充电度。

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

这是一个重载函数。

使用指定的渐变 预置 填充电度。

const QFont &QPainter::font() const

返回绘制文本时使用的当前字体。

另请参阅setFont()，drawText()和设置。

QFontInfo QPainter::fontInfo() const

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

另请参阅font()，isActive()和设置。

QFontMetrics QPainter::fontMetrics() const

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

另请参阅font()，isActive()和设置。

bool QPainter::hasClipping() const

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

另请参阅setClipping()和裁剪。

bool QPainter::isActive() const

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

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

Qt::LayoutDirection QPainter::layoutDirection() const

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

另请参阅QTextOption::textDirection，setLayoutDirection，drawText和设置。

qreal QPainter::opacity() const

返回绘图器的透明度。默认值为1。

另请参阅setOpacity。

QPaintEngine *QPainter::paintEngine() const

如果绘图器是活动的，则返回绘图器当前正在操作的绘图引擎；否则返回0。

另请参阅 isActive()。

const QPen &QPainter::pen() const

返回绘图器的当前画笔。

另请参阅 setPen() 和 设置。

QPainter::RenderHints QPainter::renderHints() const

返回一个标志，指定为此绘图器设置的渲染提示。

另请参阅 setRenderHints()，testRenderHint() 和 渲染质量。

void QPainter::resetTransform()

重置使用 translate，scale，shear，rotate，setWorldTransform，setViewport 和 setWindow 创建的任何变换。

另请参阅 坐标变换。

void QPainter::restore()

恢复当前绘图器状态（从栈中移除保存的状态）。

另请参阅 save。

void QPainter::rotate(qreal angle)

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

另请参阅 setWorldTransform 和 坐标变换。

void QPainter::save()

保存当前绘图器状态（将状态推入栈）。保存()后必须跟相应的 restore(); end() 函数会展开栈。

另请参阅 restore。

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

将坐标系按 (sx，sy) 缩放。

另请参阅 setWorldTransform 和 坐标变换。

void QPainter::setBackground(const QBrush &brush)

将绘图器的背景画刷设置为给定的brush。

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

另请参阅 背景，setBackgroundMode 和 设置。

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

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

Qt::TransparentMode（默认）绘制阴影线和文本而不设置背景像素。Qt::OpaqueMode则用当前背景色填充这些空间。

注意，为了透明地绘制位图或 pixmap，您必须使用QPixmap::setMask。

另请参阅backgroundMode，setBackground和Settings。

void QPainter::setBrush(const QBrush &brush)

将画笔的画刷设置为给定的brush。

画笔的画刷定义了形状如何被填充。

另请参阅brush和Settings。

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

这是一个重载函数。

将画笔设置为黑色并指定style。

void QPainter::setBrushOrigin(const QPointF &position)

将画刷原点设置为position。

画刷原点指定画笔画刷的(0, 0)坐标。

注意，虽然在 Qt 3 中brushOrigin() 是必要的，以便采用则小部件的背景，但从 Qt 4 开始的画笔不再这样做，除非您通过将小部件的autoFillBackground属性设置为 true 来显式地告诉它这样做。

另请参阅brushOrigin和Settings。

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

这是一个重载函数。

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

void QPainter::setBrushOrigin(const QPoint &position)

这是一个重载函数。

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

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)

启用裁剪，并使用给定的剪贴rectangle和给定的剪贴operation设置剪贴区域。默认操作是替换当前剪贴矩形。

注意，剪贴矩形是在逻辑（画笔）坐标中指定的。

另请参阅clipRegion，setClipping和Clipping。

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

这是一个重载函数。

启用裁剪，并使用指定的裁剪operation将裁剪区域设置为由给定rectangle定义的区域。

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

启用裁剪，并将裁剪区域设置为由指定点(x, y)、宽width和高height定义的矩形。

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

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

注意，裁剪区域是以逻辑坐标给出的。

另请参阅clipRegion()，setClipRect()和裁剪。

void QPainter::setClipping(bool enable)

如果enable为真，则启用裁剪；如果enable为假，则禁用裁剪。

另请参阅hasClipping()和裁剪。

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

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

另请参阅compositionMode。

void QPainter::setFont(const QFont &font)

将画笔的字体设置为给定的font。

该字体用于之后的drawText()函数。文本颜色与画笔颜色相同。

如果你设置了一个不可用的字体，Qt将会寻找一个最接近的匹配项。font()将返回你使用setFont设置的值，而fontInfo()将返回实际正在使用的字体（可能和设置的相同）。

另请参阅font()，drawText()和设置。

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。

void QPainter::setPen(const QColor &color)

这是一个重载函数。

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

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

这是一个重载函数。

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

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 , int width, int height)

这是一个重载函数。

将画家的窗口设置为以 (x, y) 开始，并具有给定的 width 和 height 的矩形。

void QPainter::setWorldMatrixEnabled(bool enable)

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

另请参阅worldMatrixEnabled、worldTransform 以及 坐标变换。

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

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

另请参阅worldTransform、transform 以及 setTransform。

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

通过 (sh, sv) 对坐标系进行剪切。

另请参阅 setWorldTransform 和 坐标变换。

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

使用由 pen 指定的画笔绘制路径 path 的轮廓（描边）。

另请参阅fillPath 和 绘图。

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 和 坐标变换。

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