<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 함수는 직사각형의 여백에 픽셀맵을 그리는 데 사용됩니다.

주어진 painter 을 사용하여 주어진 pixmap 을 주어진 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())

주어진 pixmap 에서 주어진 targetRect 사각형으로 주어진 painter 을 사용하여 표시된 sourceRect 사각형을 그립니다. 주어진 targetMarginssourceMargins 구조에 따라 픽셀맵을 9개의 세그먼트로 분할합니다. 마지막으로 주어진 rules 에 따라 픽셀맵이 그려집니다.

이 함수는 CSS3 테두리 이미지와 유사하게 크기 조정된 픽셀맵을 그리는 데 사용됩니다.

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)

지정된 widthheight 을 사용하여 지정된 painter, lineColorlineWidth 을 사용하여 (x, y)에서 시작하는 일반 직사각형을 그립니다. 직사각형의 내부는 fillnullptr 이 아닌 경우 fill 브러시로 채워집니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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, lineColorlineWidth 을 사용하여 rect 으로 지정된 일반 직사각형을 그립니다. fillnullptr 이 아닌 경우 직사각형의 내부는 fill 브러시로 채워집니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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)

지정된 widthheight, 지정된 rx 및 수직 반경 ry, 지정된 painter, lineColorlineWidth 을 사용하여 (x, y)에서 시작하는 평평한 둥근 직사각형을 그립니다. 직사각형의 내부는 fillnullptr 이 아닌 경우 fill 브러시로 채워집니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()을 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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, lineColorlineWidth 을 사용하여 rect 으로 지정된 일반 직사각형을 그립니다. fillnullptr 이 아닌 경우 직사각형의 내부는 fill 브러시로 채워집니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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 != y2x1!= x2 (즉, 선이 가로도 세로도 아닌 경우)에는 아무것도 그려지지 않습니다.

제공된 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다. 주어진 lineWidth 은 각 선의 선 너비를 지정하며, 전체 선 너비가 아닙니다. 지정된 midLineWidthQPalette::mid() 색상으로 그려진 중간 선의 너비를 지정합니다.

sunken 이 참이면 선이 가라앉고, 그렇지 않으면 선이 솟아오릅니다.

경고: 이 함수는 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 을 사용하여 p1p2 사이에 수평 또는 수직 음영선을 그립니다. 점 사이의 선이 수평도 수직도 아닌 경우 아무 것도 그려지지 않습니다.

지정된 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다. 주어진 lineWidth 은 각 선의 선 너비를 지정하며, 전체 선 너비가 아닙니다. 지정된 midLineWidthQPalette::mid() 색상으로 그려진 중간 선의 너비를 지정합니다.

sunken 이 참이면 선이 가라앉고, 그렇지 않으면 선이 솟아오릅니다.

경고: 이 함수는 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)

주어진 widthheight 을 사용하여 (x, y)에서 시작하는 음영 패널을 그려내고 주어진 painter 및 주어진 lineWidth 을 사용합니다.

주어진 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다. fillnullptr 이 아닌 경우 패널의 내부는 fill 브러시로 채워집니다.

sunken 이 참이면 패널이 가라앉은 것처럼 보이고 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()을 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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 은 음영 색상(light, darkmiddle 색상)을 지정합니다. fillnullptr 이 아닌 경우 패널의 내부는 fill 브러시로 채워집니다.

sunken 이 참이면 패널은 가라앉은 상태로 표시되고 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()을 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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)

제공된 widthheight 을 사용하여 (x, y)에서 시작하는 음영 직사각형을 painter 으로 그립니다.

제공된 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다. 주어진 lineWidth 은 각 선의 선 너비를 지정하며 전체 선 너비가 아닙니다. midLineWidthQPalette::mid() 색상으로 그려진 중간 선의 너비를 지정합니다. fillnullptr 이 아닌 경우 직사각형의 내부는 fill 브러시로 채워집니다.

sunken 이 참이면 직사각형이 움푹 들어간 모양으로 표시되고 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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 은 음영 색상(light, darkmiddle 색상)을 지정합니다. 주어진 lineWidth 은 각 선의 선 너비를 지정하며, 전체 선 너비가 아닙니다. midLineWidthQPalette::mid() 색상으로 그려진 중간 선의 너비를 지정합니다. fillnullptr 이 아닌 경우 직사각형의 내부는 fill 브러시로 채워집니다.

sunken 이 참이면 직사각형이 움푹 들어간 모양으로 나타나고 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. QStyle 의 그리기 함수를 사용하여 현재 GUI 스타일을 따르는 위젯을 만드세요.

또는 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 )에 2픽셀의 선 너비로 제공된 painter 을 사용하여 지정된 윈도우 스타일 버튼을 그립니다. fillnullptr 이 아닌 경우 버튼의 내부는 fill 브러시로 채워집니다.

지정된 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다.

sunken 이 참이면 버튼이 가라앉은 상태로 표시되고, 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 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)

이 함수는 오버로드된 함수입니다.

주어진 painter 을 사용하여 rect 으로 지정된 사각형에 2픽셀의 선 너비로 Windows 스타일 버튼을 그립니다. fillnullptr 이 아닌 경우 버튼의 내부는 fill 브러시로 채워집니다.

지정된 palette 은 음영 색상(light, darkmiddle 색상)을 지정합니다.

sunken 이 참이면 버튼이 가라앉은 상태로 표시되고, 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 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 에 2픽셀의 선폭으로 지정된 painter 을 사용하여 윈도우 스타일 패널을 그립니다. fillnullptr 이 아닌 경우 버튼의 내부는 fill 브러시로 채워집니다.

주어진 palette 은 음영 색상을 지정합니다. sunken 이 참이면 패널이 가라앉은 상태로 표시되고, 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 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)

이 함수는 오버로드된 함수입니다.

주어진 painter 을 사용하여 rect 으로 지정된 사각형에 2픽셀의 선 너비로 Windows 스타일 패널을 그립니다. fillnullptr 이 아닌 경우 버튼의 내부는 fill 브러시로 채워집니다.

지정된 palette 은 음영 색상을 지정합니다. sunken 이 참이면 패널이 가라앉은 상태로 표시되고, 그렇지 않으면 위로 올라갑니다.

경고: 이 함수는 QWidget::style() 또는 QApplication::style()를 보지 않습니다. 현재 GUI 스타일을 따르는 위젯을 만들려면 QStyle 의 그리기 함수를 사용하세요.

또는 QFrame 위젯을 사용하고 QFrame::setFrameStyle() 함수를 적용하여 음영 처리된 패널을 표시할 수 있습니다:

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

qDrawShadePanel(), qDrawWinButton() 및 QStyle참조하세요 .

© 2025 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.