<qdrawutil.h> - Drawing Utility Functions

Header: #include <qdrawutil.h>

Fonctions

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)

Description détaillée

Voir aussi QPainter.

Documentation des fonctions

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

La fonction qDrawBorderPixmap permet de dessiner une pixmap dans les marges d'un rectangle.

Dessine l'image pixmap donnée dans le rectangle target donné, en utilisant l'image painter donnée. La pixmap sera divisée en neuf segments et dessinée selon la structure margins.

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

Dessine le rectangle sourceRect indiqué à partir de pixmap dans le rectangle targetRect indiqué, en utilisant painter. La pixmap sera divisée en neuf segments selon les structures targetMargins et sourceMargins. Enfin, la pixmap sera dessinée selon la structure rules.

Cette fonction est utilisée pour dessiner une pixmap à l'échelle, similaire aux images de bordure CSS3.

Voir aussi Qt::TileRule, QTileRules, et QMargins.

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

Dessine le rectangle simple commençant à (x, y) avec les données width et height, en utilisant les données painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec la brosse fill sauf si fill est nullptr.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un simple rectangle :

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

Voir également qDrawShadeRect() et QStyle.

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

Dessine le rectangle simple spécifié par rect en utilisant les données painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec la brosse fill sauf si fill est nullptr.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un simple rectangle :

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

Il s'agit d'une fonction surchargée.

Voir aussi qDrawShadeRect() et 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)

Dessine le rectangle arrondi simple commençant à (x, y) avec les données width et height, en utilisant le rayon horizontal rx et vertical ry, spécifié painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec le pinceau fill sauf si fill est nullptr.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un simple rectangle :

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

Cette fonction a été introduite dans Qt 6.7.

Voir aussi qDrawShadeRect() et 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)

Dessine le rectangle simple spécifié par rect en utilisant le rayon horizontal rx et le rayon vertical ry, les données painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec la brosse fill sauf si fill est nullptr.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un simple rectangle :

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

Il s'agit d'une fonction surchargée.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi qDrawShadeRect() et 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)

Dessine une ligne ombrée horizontale (y1 == y2) ou verticale (x1 == x2) en utilisant l'adresse painter. Notez que rien n'est dessiné si y1!= y2 et x1!= x2 (c'est-à-dire si la ligne n'est ni horizontale ni verticale).

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ). L'adresse lineWidth spécifie la largeur de chaque ligne ; il ne s'agit pas de la largeur totale de la ligne. L'adresse midLineWidth spécifie la largeur d'une ligne centrale tracée dans la couleur QPalette::mid().

La ligne apparaît en creux si sunken est vrai, sinon elle est en relief.

Attention : Cette fonction ne tient pas compte de QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher une ligne ombrée :

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

Voir également qDrawShadeRect(), qDrawShadePanel() et QStyle.

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

Trace une ligne ombrée horizontale ou verticale entre p1 et p2 en utilisant le point donné painter. Notez que rien n'est dessiné si la ligne entre les points n'est ni horizontale ni verticale.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ). L'adresse lineWidth spécifie la largeur de chaque ligne ; il ne s'agit pas de la largeur totale de la ligne. L'adresse midLineWidth spécifie la largeur d'une ligne centrale tracée dans la couleur QPalette::mid().

La ligne apparaît en creux si sunken est vrai, sinon elle est en relief.

Attention : Cette fonction ne tient pas compte de QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher une ligne ombrée :

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

Il s'agit d'une fonction surchargée.

Voir également qDrawShadeRect(), qDrawShadePanel() et 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)

Dessine le panneau ombré commençant à (x, y) avec les données width et height en utilisant les données painter et lineWidth.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ). L'intérieur du panneau est rempli avec le pinceau fill sauf si fill est nullptr.

Le panneau apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un panneau ombré :

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

Voir également qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() et QStyle.

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

Dessine le panneau ombré dans le rectangle spécifié par rect en utilisant les données painter et lineWidth.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ). L'intérieur du panneau est rempli avec le pinceau fill sauf si fill est nullptr.

Le panneau apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un panneau ombré :

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

Il s'agit d'une fonction surchargée.

Voir aussi qDrawWinPanel(), qDrawShadeLine(), qDrawShadeRect() et 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)

Dessine le rectangle ombré commençant à (x, y) avec les données width et height en utilisant les données painter.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle couleurs. L'adresse lineWidth spécifie la largeur de ligne pour chacune des lignes ; il ne s'agit pas de la largeur totale de la ligne. L'adresse midLineWidth spécifie la largeur d'une ligne centrale tracée dans la couleur QPalette::mid(). L'intérieur du rectangle est rempli avec le pinceau fill sauf si fill est nullptr.

Le rectangle apparaît en creux si sunken est vrai, sinon il est en relief.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un rectangle ombré :

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

Voir également qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() et QStyle.

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

Dessine le rectangle ombré spécifié par rect à l'aide de painter.

La donnée palette spécifie les couleurs d'ombrage (light, dark et middle couleurs. L'adresse lineWidth spécifie la largeur de chaque ligne ; il ne s'agit pas de la largeur totale de la ligne. L'adresse midLineWidth spécifie la largeur d'une ligne centrale tracée dans la couleur QPalette::mid(). L'intérieur du rectangle est rempli avec le pinceau fill sauf si fill est nullptr.

Le rectangle apparaît en creux si sunken est vrai, sinon il est en relief.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un rectangle ombré :

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

Il s'agit d'une fonction surchargée.

Voir aussi qDrawShadeLine(), qDrawShadePanel(), qDrawPlainRect() et QStyle.

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

Dessine le bouton de style Windows spécifié par le point donné (x, y}, width et height en utilisant le fichier fourni painter avec une largeur de ligne de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill sauf si fill est nullptr.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ).

Le bouton apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style()-> Utilisez les fonctions de dessin dans QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Voir aussi qDrawWinPanel() et QStyle.

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

Dessine le bouton de style Windows dans le rectangle spécifié par rect en utilisant l'adresse painter avec une largeur de ligne de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill sauf si fill est nullptr.

L'adresse palette spécifie les couleurs d'ombrage (light, dark et middle ).

Le bouton apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style()-> Utilisez les fonctions de dessin dans QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Il s'agit d'une fonction surchargée.

Voir aussi qDrawWinPanel() et QStyle.

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

Dessine le panneau de style Windows spécifié par le point donné(x, y), width et height en utilisant le point fourni painter avec une largeur de ligne de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill sauf si fill est nullptr.

L'adresse palette spécifie les couleurs d'ombrage. Le panneau apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un panneau ombré :

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

Voir également qDrawShadePanel(), qDrawWinButton() et QStyle.

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

Dessine le panneau de style Windows dans le rectangle spécifié par rect en utilisant l'adresse painter avec une largeur de ligne de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill sauf si fill est nullptr.

L'adresse palette spécifie les couleurs d'ombrage. Le panneau apparaît enfoncé si sunken est vrai, sinon il est surélevé.

Attention : Cette fonction ne regarde pas QWidget::style() ou QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui suivent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget QFrame et appliquer la fonction QFrame::setFrameStyle() pour afficher un panneau ombré :

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

Il s'agit d'une fonction surchargée.

Voir également qDrawShadePanel(), qDrawWinButton() et 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.