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

使用当前设置的font() 返回text 的边界矩形，该矩形将在给定的rectangle 与指定的flags 之间绘制；也就是说，该函数将告诉您drawText() 函数在给定相同参数时的绘制位置。

如果使用指定的flags 使text 与给定的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)

这是一个重载函数。

使用当前设置的font() 返回text 的边界矩形，该矩形在使用指定的flags 和给定的rectangle 内部绘制时会显示出来。

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

这是一个重载函数。

该重载函数不将 flags 指定为Qt::AlignmentFlag 和Qt::TextFlag 的 bitwise OR，而是使用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

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

另请参阅 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 点钟位置。

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 点钟位置。

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)

这是一个重载函数。

用给定的width 和height 绘制以 (x,y) 为起点的矩形所定义的椭圆。

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)

将给定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)

这是一个重载函数。

绘制给定image 的矩形部分source ，其原点位于给定的point 。

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

这是一个重载函数。

绘制给定image 的矩形部分source ，其原点位于给定的point 。

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)

这是一个重载函数。

通过将image 的一部分复制到绘图设备，在 (x,y) 处绘制图像。

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

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

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

在给定的point 上重播给定的picture 。

QPicture 类是记录和重播QPainter 命令的绘画设备。图片以独立于平台的格式将绘制命令序列化到 IO 设备中。所有可以在 widget 或像素图上绘制的内容都可以存储在图片中。

当调用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 点钟位置。

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)

这是一个重载函数。

绘制给定pixmap 的矩形部分source ，其原点位于给定的point 。

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

这是一个重载函数。

绘制给定pixmap 的矩形部分source ，其原点位于给定的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)

这是一个重载函数。

使用给定的width 和height 将pixmap 绘制到位置 (x,y) 的矩形中。

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

这是一个重载函数。

通过将给定的pixmap 的一部分复制到绘制设备中，在 (x,y) 处绘制像素图。

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

这是一个重载函数。

以给定的pixmap 为原点（sx,sy ），宽度为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)

以当前定义的文本方向绘制给定的text ，从给定的position 开始。

该函数不处理换行符（\n），因为它无法将文本分成多行，也无法显示换行符。如果您想绘制带有换行符的多行文本，或想将文本包裹起来，请使用 QPainter::drawText() 重载，该重载会获取一个矩形。

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

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

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

这是一个重载函数。

以当前定义的文本方向绘制给定的text ，从给定的position 开始。

默认情况下，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 参数是下列标志的位顺向 OR：

• 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 参数是以下标志的位相 OR：

• 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 内绘制一个平铺的pixmap ，其原点位于给定的position 。

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

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

position 偏移量始终位于绘制者坐标系中，与显示设备像素比例无关。

另请参阅 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) 指定要绘制到的pixmap 中的左上角点；默认值为 (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)

这是一个重载函数。

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

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)

这是一个重载函数。

使用指定的梯度preset 填充给定的rectangle 。

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

使用指定的梯度preset 填充给定的rectangle 。

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

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

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

这是一个重载函数。

使用给定的梯度preset ，用给定的width 和height 填充从 (x,y) 开始的矩形。

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

这是一个重载函数。

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

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

这是一个重载函数。

用给定的width 和height 填充从 (x,y) 开始的矩形，并使用给定的color 。

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

这是一个重载函数。

用给定的width 和height 填充从 (x,y) 开始的矩形，并使用给定的brush 。

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

这是一个重载函数。

用给定的width 和height 填充从 (x,y) 开始的矩形，并使用给定的color 。

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 。

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

这是一个重载函数。

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

void QPainter::setBrushOrigin(const QPointF &position)

将画笔原点设置为position 。

画笔原点指定了画笔的（0，0）坐标。

请注意，虽然在 Qt XML 3 中需要使用brushOrigin() 来为 widget 采用父代的背景，但现在不再需要了，因为 Qt XML 4 画笔不会绘制背景，除非您通过将 widget 的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)

启用剪辑，并使用给定的剪辑operation 将剪辑区域设置为给定的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)

这是一个重载函数。

启用剪辑，并使用给定的剪辑operation 将剪辑区域设置为给定的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 。

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 为 true，则在绘制器上设置给定的呈现hint ；否则清除呈现提示。

另请参阅 setRenderHints(),renderHints() 和Rendering Quality 。

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

如果on 为 true，则在绘制器上设置给定的呈现hints ；否则清除呈现提示。

另请参阅 setRenderHint(),renderHints() 和Rendering Quality 。

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

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

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

void QPainter::setViewTransformEnabled(bool enable)

如果enable 为 true，则启用视图转换；如果enable 为 false，则禁用视图转换。

另请参阅 viewTransformEnabled() 和Window-Viewport Conversion。

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 为 true，则启用变换；如果enable 为 false，则禁用变换。世界变换矩阵不会改变。

另请参阅 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()。