<qdrawutil.h> - 绘图工具函数

函数文档

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

qDrawBorderPixmap函数用于在矩形的边框中绘制位图。

使用指定的painter将给定的pixmap绘制到指定的target矩形中。该pixmap将被分成九个部分，并根据margins结构进行绘制。

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

使用给定的painter将给定pixmap中的指示sourceRect矩形绘制到给定targetRect矩形中。位图将根据给定的targetMargins和sourceMargins结构分成九个部分。最后，根据给定的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)

使用指定的painter、lineColor和lineWidth绘制起始于(x, y)的普通矩形，宽度为width，高度为height。除非fill为nullptr，否则矩形内部填充fill刷子。

或者，您可以使用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)

这是一个重载函数。

使用指定的 painter、lineColor 和 lineWidth 绘制由 rect 指定的普通矩形。除非 fill 是 nullptr，否则矩形的内部将填充 fill 刷漆。

或者，您可以使用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 的普通圆角矩形，使用指定的 painter、lineColor 和 lineWidth。除非 fill 是 nullptr，否则矩形的内部将填充 fill 刷漆。

或者，您可以使用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)

这是一个重载函数。

使用水平 rx 和垂直半径 ry，使用指定的 painter、lineColor 和 lineWidth 绘制由 rect 指定的普通矩形。除非 fill 是 nullptr，否则矩形的内部将填充 fill 刷漆。

或者，您可以使用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（即线既不是水平的也不是垂直的），则不绘制任何内容。

提供的调色板指定了阴影颜色（浅色、深色和中间色）。给定的lineWidth指定了每条线的线宽；它不是线条的总宽度。给定的midLineWidth指定了绘制于QPalette::mid()颜色的中间线的宽度。

如果sunken为真，则线条显得凹陷，否则为凸起。

或者，您可以使用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之间绘制水平或垂直阴影线条。注意，如果两点之间的线条既不是水平也不是垂直，则不会绘制任何东西。

提供的调色板指定了阴影颜色（浅色、深色和中间色）。给定的lineWidth指定了每条线的线宽；它不是线条的总宽度。给定的midLineWidth指定了绘制于QPalette::mid()颜色的中间线的宽度。

如果sunken为真，则线条显得凹陷，否则为凸起。

或者，您可以使用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)

使用给定的painter和使用给定的lineWidth在给定的点(x, y)和给定的大小width和height处绘制阴影面板。

给定的palette指定了阴影颜色（浅色、深色和中间色）。除非fill是nullptr，否则面板内侧填充了fill画笔。

如果sunken为真，则面板显得凹陷，否则为凸起。

或者，您可以使用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)

这是一个重载函数。

使用给定的painter和给定的lineWidth在由rect指定的矩形处绘制阴影面板。

给定的palette指定了阴影颜色（浅色、深色和中间色）。除非fill是nullptr，否则面板内侧填充了fill画笔。

如果sunken为真，则面板显得凹陷，否则为凸起。

或者，您可以使用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)

在给定的 (x, y) 位置开始，使用提供的 painter 绘制具有给定 width 和 height 的阴影矩形。

提供的 palette 指定了阴影颜色（浅色、深色和中间颜色）。给定的 lineWidth 指定了每条线的线宽；它不是总线宽。midLineWidth 指定了在 QPalette::mid() 颜色中绘制的中间线的宽度。除非 fill 为 nullptr，否则矩形的内部将填充 fill 刷子。

如果 sunken 为真，则矩形看起来是凹进去的，否则是凸起的。

或者您可以使用 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)

这是一个重载函数。

使用给定的 painter 绘制由 rect 指定的阴影矩形。

提供的 palette 指定了阴影颜色（浅色、深色和中间颜色）。给定的 lineWidth 指定了每条线的线宽；它不是总线宽。midLineWidth 指定了在 QPalette::mid() 颜色中绘制的中间线的宽度。除非 fill 为 nullptr，否则矩形的内部将填充 fill 刷子。

如果 sunken 为真，则矩形看起来是凹进去的，否则是凸起的。

或者您可以使用 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)

使用提供的 painter 在给定的点 (x, y)、width 和 height 位置绘制 Windows 风格的按钮，线宽为 2 像素。按钮内部填充 fill 刷子，除非 fill 为 nullptr。

给定的 palette 指定了阴影颜色（浅色、深色和 中间颜色）。

如果 sunken 为真，则按钮看起来是凹进去的，否则是凸起的。

另请参阅qDrawWinPanel() 和 QStyle。

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

这是一个重载函数。

使用给定的painter以及2像素的线宽，在由rect指定的矩形内绘制Windows样式的按钮。除非fill是nullptr，否则按钮的内部将以fill画笔填充。

给定的 palette 指定了阴影颜色（浅色、深色和 中间颜色）。

如果 sunken 为真，则按钮看起来是凹进去的，否则是凸起的。

另请参阅qDrawWinPanel() 和 QStyle。

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

使用提供的painter以及2像素的线宽，根据给定的点(x, y)、width和height绘制Windows样式的面板。除非fill是nullptr，否则按钮的内部将以fill画笔填充。

给定的palette指定着色颜色。如果sunken为true，则面板看起来是凹入的，否则是凸起的。

或者，您可以使用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)

这是一个重载函数。

使用给定的painter以及2像素的线宽，在由rect指定的矩形内绘制Windows样式的面板。除非fill是nullptr，否则面板的内部将以fill画笔填充。

给定的palette指定着色颜色。如果sunken为true，则面板看起来是凹入的，否则是凸起的。

或者，您可以使用QFrame小部件并应用QFrame::setFrameStyle()函数来显示阴影面板

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

参见qDrawShadePanel，qDrawWinButton和QStyle。