<qdrawutil.h> - Drawing Utility Functions

Header: #include <qdrawutil.h>

機能

void qDrawBorderPixmap(QPainter *painter, const QRect &target, const QMargins &margins, const QPixmap &pixmap)
void qDrawBorderPixmap(QPainter *painter, const QRect &targetRect, const QMargins &targetMargins, const QPixmap &pixmap, const QRect &sourceRect, const QMargins &sourceMargins, const QTileRules &rules = QTileRules())
void qDrawPlainRect(QPainter *painter, int x, int y, int width, int height, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
void qDrawPlainRect(QPainter *painter, const QRect &rect, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
(since 6.7) void qDrawPlainRoundedRect(QPainter *painter, int x, int y, int width, int height, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
(since 6.7) void qDrawPlainRoundedRect(QPainter *painter, const QRect &rect, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)
void qDrawShadeLine(QPainter *painter, int x1, int y1, int x2, int y2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)
void qDrawShadeLine(QPainter *painter, const QPoint &p1, const QPoint &p2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)
void qDrawShadePanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)
void qDrawShadePanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)
void qDrawShadeRect(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)
void qDrawShadeRect(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)
void qDrawWinButton(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
void qDrawWinButton(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
void qDrawWinPanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)
void qDrawWinPanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)

詳細な説明

関連項目: QPainter 。

関数のドキュメント

void qDrawBorderPixmap(QPainter *painter, const QRect &target, const QMargins &margins, const QPixmap &pixmap)

qDrawBorderPixmap 関数は、矩形の余白にピクマップを描画するためのものです。

指定されたpixmap を、指定されたpainter を使用して、指定されたtarget 矩形内に描画します。ピクマップは9つのセグメントに分割され、margins 構造体に基づいて描画されます。

void qDrawBorderPixmap(QPainter *painter, const QRect &targetRect, const QMargins &targetMargins, const QPixmap &pixmap, const QRect &sourceRect, const QMargins &sourceMargins, const QTileRules &rules = QTileRules())

指定されたsourceRect 矩形を、指定されたpixmap から、指定されたtargetRect 矩形に、指定されたpainter を使用して描画します。ピクマップは、指定されたtargetMargins およびsourceMargins 構造体に従って9つのセグメントに分割されます。最後に、ピクマップは指定されたrules に従って描画されます。

この関数は、CSS3のborder-imagesと同様に、拡大・縮小されたピクマップを描画するために使用されます。

Qt::TileRule 、QTileRules 、およびQMarginsも参照してください 。

void qDrawPlainRect(QPainter *painter, int x, int y, int width, int height, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)

指定された `x`、`y` を起点とし、指定された `width ` および `height` を用いて、指定された `painter`、`lineColor `、`lineWidth` を使用して、プレーンな長方形を描画します。fill が `nullptr` でない限り、長方形の内部は `fill ` ブラシで塗りつぶされます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに従ったウィジェットを作成するには、QStyle の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、シンプルな矩形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Plain);

qDrawShadeRect() およびQStyleも参照してください 。

void qDrawPlainRect(QPainter *painter, const QRect &rect, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)

rect で指定された単純な矩形を、指定されたpainter 、lineColor 、およびlineWidth を使用して描画します。fill がnullptr でない限り、矩形の内部はfill ブラシで塗りつぶされます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle 内の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、単純な長方形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Plain);

これはオーバーロードされた関数です。

qDrawShadeRect() およびQStyleも参照してください 。

[since 6.7] void qDrawPlainRoundedRect(QPainter *painter, int x, int y, int width, int height, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)

(x,y) を起点として、指定されたwidth およびheight を用い、水平半径rx および垂直半径ry 、指定されたpainter 、lineColor 、およびlineWidth に基づいて、シンプルな角丸長方形を描画します。fill がnullptr でない限り、長方形の内部はfill ブラシで塗りつぶされます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle()関数を適用して、単純な矩形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Plain);

この関数は Qt 6.7 で導入されました。

qDrawShadeRect() およびQStyleも参照してください 。

[since 6.7] void qDrawPlainRoundedRect(QPainter *painter, const QRect &rect, qreal rx, qreal ry, const QColor &lineColor, int lineWidth = 1, const QBrush *fill = nullptr)

rect で指定された単純な長方形を、水平方向のrx と垂直方向の半径ry 、および指定されたpainter 、lineColor 、lineWidth を用いて描画します。fill がnullptr でない限り、長方形の内部はfill ブラシで塗りつぶされます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、単純な長方形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Plain);

これはオーバーロードされた関数です。

この関数は Qt 6.7 で導入されました。

qDrawShadeRect() およびQStyleも参照してください 。

void qDrawShadeLine(QPainter *painter, int x1, int y1, int x2, int y2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)

指定されたpainter を使用して、水平(y1 ==y2 )または垂直(x1 ==x2 )の網掛け線を描画します。y1!=y2 かつx1!=x2 の場合(つまり、線が水平でも垂直でもない場合)、何も描画されないことに注意してください。

指定されたpalette は、シェーディングの色(light 、dark 、およびmiddle の色)を指定します。指定されたlineWidth は、各線の線幅を指定します。これは線全体の幅ではありません。指定されたmidLineWidth は、QPalette::mid()の色で描画される中央の線の幅を指定します。

sunken がtrueの場合、線はくぼんで表示され、そうでない場合は盛り上がったように表示されます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに従ったウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きの線を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::HLine | QFrame::Sunken);

qDrawShadeRect()、qDrawShadePanel()、およびQStyleも参照してください 。

void qDrawShadeLine(QPainter *painter, const QPoint &p1, const QPoint &p2, const QPalette &palette, bool sunken = true, int lineWidth = 1, int midLineWidth = 0)

指定されたpainter を使用して、p1 とp2 の間に、水平または垂直の網掛け線を引きます。なお、2点間の線が水平でも垂直でもない場合は、何も描画されません。

指定されたpalette は、シェーディングの色(light 、dark 、middle の色)を指定します。指定されたlineWidth は、各線の線幅を指定します。これは線の合計幅ではありません。指定されたmidLineWidth は、QPalette::mid()の色で描画される中央線の幅を指定します。

sunken がtrueの場合、線はくぼんだように表示され、そうでない場合は盛り上がったように表示されます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きの線を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::HLine | QFrame::Sunken);

これはオーバーロードされた関数です。

qDrawShadeRect()、qDrawShadePanel()、およびQStyleも参照してください 。

void qDrawShadePanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)

指定された `width ` および `height ` を使用し、提供された `painter ` および指定された `lineWidth` を用いて、座標 `(x,y)` から始まる陰影付きパネルを描画します。

指定されたpalette は、シェーディングの色(light 、dark 、middle の色)を指定します。fill がnullptr でない限り、パネルの内部はfill ブラシで塗りつぶされます。

sunken がtrueの場合、パネルはくぼんで表示され、そうでない場合は盛り上がったように表示されます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きのパネルを表示することもできます:

QFrame frame:
frame.setFrameStyle( QFrame::Panel | QFrame::Sunken);

qDrawWinPanel()、qDrawShadeLine()、qDrawShadeRect()、およびQStyleも参照してください 。

void qDrawShadePanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, const QBrush *fill = nullptr)

rect で指定された矩形内に、指定されたpainter およびlineWidth を使用して、陰影付きのパネルを描画します。

指定されたpalette は、シェーディングの色(light 、dark 、およびmiddle の色)を指定します。fill がnullptr でない限り、パネルの内部はfill ブラシで塗りつぶされます。

sunken がtrueの場合、パネルは窪んで表示され、そうでない場合は盛り上がったように表示されます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きのパネルを表示することもできます:

QFrame frame:
frame.setFrameStyle( QFrame::Panel | QFrame::Sunken);

これはオーバーロードされた関数です。

qDrawWinPanel()、qDrawShadeLine()、qDrawShadeRect()、およびQStyleも参照してください 。

void qDrawShadeRect(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)

指定されたwidth およびheight に基づき、与えられたpainter を使用して、(x,y) を起点とする塗りつぶされた長方形を描画します。

指定されたpalette は、陰影の色(light 、dark 、middle )を指定します。指定されたlineWidth は、各線の線幅を指定します。これは合計の線幅ではありません。midLineWidth は、QPalette::mid()の色で描画される中央の線の幅を指定します。矩形の内部は、fill がnullptr でない限り、fill ブラシで塗りつぶされます。

sunken がtrueの場合、矩形はくぼんで表示され、それ以外の場合は盛り上がったように表示されます。

警告: この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle()関数を適用して、陰影付きの矩形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Raised);

qDrawShadeLine()、qDrawShadePanel()、qDrawPlainRect()、およびQStyleも参照してください 。

void qDrawShadeRect(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, int lineWidth = 1, int midLineWidth = 0, const QBrush *fill = nullptr)

rect で指定された塗りつぶし矩形を、指定されたpainter を使用して描画します。

指定されたpalette は、シェーディングの色(light 、dark 、middle )を指定します。指定されたlineWidth は、各線の線幅を指定するものであり、線幅の合計ではありません。midLineWidth は、QPalette::mid()の色で描画される中央線の幅を指定します。矩形の内部は、fill がnullptr でない限り、fill ブラシで塗りつぶされます。

sunken がtrueの場合、矩形は窪んで表示され、そうでない場合は盛り上がったように表示されます。

警告: この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに従ったウィジェットを作成するには、QStyle の描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きの矩形を表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::Box | QFrame::Raised);

これはオーバーロードされた関数です。

qDrawShadeLine()、qDrawShadePanel()、qDrawPlainRect()、およびQStyleも参照してください 。

void qDrawWinButton(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)

指定された座標(x 、y}、width 、height )で指定されたWindowsスタイルのボタンを、引数として渡されたpainter を使用し、線幅2ピクセルで描画します。fill がnullptr でない限り、ボタンの内部はfill ブラシで塗りつぶされます。

指定されたpalette は、シェーディングの色(light 、dark 、およびmiddle の色)を指定します。

sunken が true の場合、ボタンはくぼんで表示され、そうでない場合は盛り上がって表示されます。

警告: この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

qDrawWinPanel() およびQStyleも参照してください 。

void qDrawWinButton(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)

rect で指定された矩形に、指定されたpainter を使用し、線幅 2 ピクセルで Windows スタイルのボタンを描画します。fill がnullptr でない限り、ボタンの内部はfill ブラシで塗りつぶされます。

指定されたpalette は、シェーディングの色(light 、dark 、およびmiddle の色)を指定します。

sunken がtrueの場合、ボタンは凹んで表示され、そうでない場合は凸って表示されます。

警告: この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

これはオーバーロードされた関数です。

qDrawWinPanel() およびQStyleも参照してください 。

void qDrawWinPanel(QPainter *painter, int x, int y, int width, int height, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)

指定された点(x 、y )、width 、およびheight によって指定されたWindowsスタイルのパネルを、提供されたpainter を使用して、線幅2ピクセルで描画します。fill がnullptr でない限り、ボタンの内部はfill ブラシで塗りつぶされます。

指定されたpalette は、陰影の色を指定します。sunken がtrueの場合、パネルはくぼんで見え、そうでない場合は盛り上がったように見えます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きのパネルを表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::WinPanel | QFrame::Raised);

qDrawShadePanel()、qDrawWinButton()、およびQStyleも参照してください 。

void qDrawWinPanel(QPainter *painter, const QRect &rect, const QPalette &palette, bool sunken = false, const QBrush *fill = nullptr)

rect で指定された矩形内に、指定されたpainter を使用し、線幅2ピクセルでWindowsスタイルのパネルを描画します。fill がnullptr でない限り、ボタンの内部はfill ブラシで塗りつぶされます。

指定されたpalette はシェーディングの色を指定します。sunken がtrueの場合、パネルはくぼんで表示され、そうでない場合は盛り上がったように表示されます。

警告:この関数は 、QWidget::style() やQApplication::style() を参照しません。現在の GUI スタイルに準拠したウィジェットを作成するには、QStyle にある描画関数を使用してください。

あるいは、QFrame ウィジェットを使用し、QFrame::setFrameStyle() 関数を適用して、陰影付きのパネルを表示することもできます:

QFrame frame:
frame.setFrameStyle(QFrame::WinPanel | QFrame::Raised);

これはオーバーロードされた関数です。

qDrawShadePanel()、qDrawWinButton()、およびQStyleも参照してください 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.