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 の境界矩形を返します。これは、指定されたrectangle 内で、指定されたflags を使用し、現在設定されているfont()を用いて描画された際の表示結果となります。つまり、この関数は、同じ引数が与えられた場合に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)

指定されたrectangle 内で、指定されたflags を使用し、現在設定されているfont()を用いて描画された際の、text の境界矩形を返します。

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

このオーバーロードされた関数は、フラグをQt::AlignmentFlag とQt::TextFlag のビット単位の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

現在のブラシの原点を返します。正確な原点を取得するには、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度単位で指定する必要があります。つまり、円周1周は5760（16 × 360）に相当します。角度の正の値は反時計回り、負の値は時計回りを意味します。 0度は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度単位で指定する必要があります。つまり、1周は 5760 (16 × 360) となります。角度の正の値は反時計回り、負の値は時計回りを意味します。 0度は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度を超える角度が少なくとも1つ含まれている場合、結果は未定義となります。

一部のプラットフォーム（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)

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)

指定されたimage を、指定されたpoint に描画します。

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

指定されたimage を、指定されたpoint に描画します。

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

「Painter Paths」の例および「Vector Deformation」の例も参照してください 。

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

指定されたpicture を、指定されたpoint で再生します。

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)

指定されたpicture を、指定されたpoint で再生します。

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

指定されたpicture を、点(x,y)に描画します。

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

指定された `rectangle`、`startAngle `、および `spanAngle` によって定義される円グラフを描画します。

円グラフは、現在のbrush()で塗りつぶされます。

startAngle および spanAngle は、1度の16分の1単位で指定する必要があります。つまり、円周全体は 5760（16 × 360）に相当します。角度の正の値は反時計回り、負の値は時計回りを意味します。 0度は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)

指定された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)

指定されたpixmap を、座標 (x,y) に描画します。

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)

指定された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 が 0 の場合、ピクマップの幅/高さが使用され、オフセット 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 に、現在のペンの色を使用して1つの点を描画します。

「座標系」も参照してください 。

void QPainter::drawPoint(const QPoint &position)

指定されたposition 座標に、現在のペンの色を使用して1つの点を描画します。

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

位置 (x,y) に1つの点を描画します。

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)

指定されたpoints によって定義された多角形を、塗りつぶしルールfillRule を使用して描画します。

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

指定されたpoints によって定義された多角形を、塗りつぶしルールfillRule を使用して描画します。

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)

指定されたstaticText を、指定されたtopLeftPosition に描画します。

テキストは、ペインターに設定されたフォントおよび変形を使用して描画されます。ペインターに設定されたフォントおよび／または変形が、QStaticText のレイアウト初期化時に使用されたものと異なる場合、レイアウトを再計算する必要があります。QStaticText::prepare() を使用して、staticText を、後で描画される際のフォントおよび変形で初期化してください。

topLeftPosition が、staticText が初期化された時点、または最後に描画された時点の状態と異なっている場合、テキストを新しい位置に変換する際にわずかなオーバーヘッドが発生します。

QStaticTextも参照してください 。

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

staticText をtopLeftPosition に描画します。

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

指定されたtext を、rectangle に描画します。この際、option を使用して、位置、方向、および向きを制御します。option で指定されたオプションは、QPainter オブジェクト自体に設定されたオプションよりも優先されます。

デフォルトでは、QPainter はアンチエイリアス処理を施してテキストを描画します。

setFont() およびsetPen()も参照してください 。

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

指定されたtext を、位置(x,y)に、ペインターで現在定義されているテキスト方向を使用して描画します。

デフォルトでは、QPainter はアンチエイリアス処理を施してテキストを描画します。

setFont() およびsetPen()も参照してください 。

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

指定されたtext を、指定されたflags に従って、指定されたrectangle 内に描画します。

boundingRect （nullでない場合）は、テキスト全体を囲むように境界矩形を設定するために使用されます。たとえば、次の図では、点線はこの関数によって計算された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)

指定されたtext を、指定されたrectangle 内に描画します。rectangle とアラインメントflags によって、text のアンカーが定義されます。

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

boundingRect （nullでない場合）は、テキスト全体を囲むためにバウンディング矩形がどのような形状であるべきかを指定します。例えば、次の図では、点線は関数によって計算された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)

指定されたtext を、原点 (x,y)、width 、height を持つ矩形内に描画します。

boundingRect （nullでない場合）は、テキスト全体を囲むために境界矩形がどのようなものになるべきかを指定します。例えば、次の図では、点線は関数によって計算された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 の内部に、指定されたposition を原点として、pixmap をタイル状に描画します。

drawTiledPixmap() を呼び出すことは、drawPixmap() を数回呼び出して領域をピクマップで塗りつぶす（タイル状に並べる）ことと同様ですが、基盤となるウィンドウシステムによっては、はるかに効率的になる可能性があります。

drawTiledPixmap() は、高 dpi ディスプレイ（devicePixelRatio > 1）でも、通常の dpi ディスプレイと同じ視覚的なタイルパターンを生成します。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 の内側に、指定されたposition を原点として、pixmap をタイル状に描画します。

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)

指定された `path ` を、指定された `brush` を使用して塗りつぶします。輪郭線は描画されません。

あるいは、QBrush の代わりにQColor を指定することもできます。QBrush のコンストラクタ（QColor 引数を受け取る）は、自動的にソリッドパターンブラシを作成します。

drawPath()も参照してください 。

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

指定されたrectangle に、指定されたbrush を埋め込みます。

あるいは、QBrush の代わりにQColor を指定することもできます。QBrush コンストラクタ（QColor 引数を受け取る）は、自動的にソリッドパターンブラシを作成します。

drawRect()も参照してください 。

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

指定されたrectangle に、指定されたグラデーションpreset を適用します。

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

指定されたrectangle を、指定されたブラシstyle で塗りつぶします。

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)

指定されたrectangle を、指定されたブラシstyle で塗りつぶします。

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)

(x,y) を起点とする長方形を、指定されたwidth およびheight を用いて、指定されたグラデーションpreset で塗りつぶします。

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)

(x,y) を起点とする矩形を、指定されたwidth およびheight を用いて、指定されたcolor を使用して塗りつぶします。

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

(x,y) を起点とする矩形を、指定されたwidth およびheight を用いて、指定されたbrush を使用して塗りつぶします。

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

(x,y) を起点とする矩形を、指定されたwidth およびheight を用いて、指定された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も参照してください 。

[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 のペインターは、ウィジェットの `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も参照してください 。

[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 が 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 がtrueの場合、指定されたtransform は現在の行列と合成されます。そうでない場合は、現在の行列が置き換えられます。

transform() およびsetWorldTransform()も参照してください 。

void QPainter::setViewTransformEnabled(bool enable)

enable がtrueの場合はビュー変換を有効にし、enable がfalseの場合はビュー変換を無効にします。

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 が true の場合は変換を有効にし、enable が false の場合は変換を無効にします。ワールド変換行列は変更されません。

worldMatrixEnabled()、worldTransform()、およびCoordinate Transformationsも参照してください 。

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

ワールド変換行列を設定します。combine がtrueの場合、指定された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()も参照してください 。