<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 image pixmap dans les marges d'un rectangle.

Elle dessine l’image de type « pixmap » ( pixmap ) spécifiée dans le rectangle « target » indiqué, en utilisant la structure « painter » fournie. L’image sera divisée en neuf segments et dessinée conformément à 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 d'sourceRect indiqué à partir de l'pixmap fournie dans le rectangle targetRect spécifié, en utilisant le painter fourni. La carte de pixels sera divisée en neuf segments conformément aux structures targetMargins et sourceMargins fournies. Enfin, la carte de pixels sera dessinée selon le rules fourni.

Cette fonction est utilisée pour dessiner une image pixmap mise à l'échelle, à l'instar des images de bordure CSS3

Voir également 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 un rectangle simple dont les coins de départ sont situés en (x, y), avec les paramètres width et height fournis, en utilisant les valeurs spécifiées pour painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec le pinceau fill, sauf si fill vaut nullptr.

Avertissement : cette fonction ne tient pas compte des fonctions QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin disponibles dans QStyle pour créer des widgets respectant le style actuel de l’interface graphique.

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

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 à l’aide des paramètres painter, lineColor et lineWidth fournis. L’intérieur du rectangle est rempli avec le pinceau fill, sauf si fill est défini sur nullptr.

Avertissement : cette fonction ne tient pas compte des fonctions QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui respectent le style actuel de l’interface graphique.

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

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

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

Voir également 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 un rectangle arrondi simple à partir des coordonnées (x, y) avec les paramètres width et height fournis, en utilisant le rayon horizontal rx et le rayon vertical ry, ainsi que les coordonnées painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec le pinceau fill, sauf si fill est défini sur nullptr.

Avertissement : cette fonction ne tient pas compte des fonctions QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui respectent 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 également 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 l'rx horizontale et le rayon vertical ry, ainsi que les valeurs données painter, lineColor et lineWidth. L'intérieur du rectangle est rempli avec le pinceau fill, sauf si fill est défini sur nullptr.

Avertissement : cette fonction ne tient pas compte de ` QWidget::style()` ni de ` QApplication::style()`. Utilisez les fonctions de dessin de ` QStyle ` pour créer des widgets qui respectent le style actuel de l'interface graphique.

Vous pouvez également utiliser un widget de type « 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 également 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'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’ palette fourni spécifie les couleurs de remplissage (couleurslight, dark et middle ). L’ lineWidth fourni spécifie la largeur de chacune des lignes ; il ne s’agit pas de la largeur totale de la ligne. L’ midLineWidth fourni spécifie la largeur d’une ligne centrale dessinée dans la couleur QPalette::mid().

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

Avertissement : cette fonction ne tient pas compte des paramètres QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets respectant 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)

Dessine une ligne ombrée horizontale ou verticale entre p1 et p2 en utilisant l'painter fournie. Notez que rien n'est dessiné si la ligne entre les points ne serait ni horizontale ni verticale.

L’ palette fourni spécifie les couleurs de l’ombrage (couleurslight, dark et middle ). L’ lineWidth fourni spécifie la largeur de chacune des lignes ; il ne s’agit pas de la largeur totale de la ligne. L’ midLineWidth fourni spécifie la largeur d’une ligne centrale dessinée dans la couleur QPalette::mid().

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

Avertissement : cette fonction ne tient pas compte des paramètres QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets respectant 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é à partir des coordonnées (x, y) avec les paramètres width et height fournis, en utilisant les paramètres painter fournis et le paramètre lineWidth spécifié.

La propriété palette spécifie les couleurs d’ombrage (couleurslight, dark et middle ). L’intérieur du panneau est rempli avec le pinceau fill, sauf si fill est défini sur nullptr.

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

Avertissement : cette fonction ne tient pas compte des paramètres QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets respectant 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 à l'aide des paramètres painter et lineWidth fournis.

Les paramètres « palette » spécifient les couleurs d’ombrage (couleurs «light », « dark » et « middle »). L’intérieur du panneau est rempli avec le pinceau « fill », sauf si « fill » vaut « nullptr ».

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

Avertissement : cette fonction ne tient pas compte de QWidget::style() ni de QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets qui respectent 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 également 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é dont les coins sont situés respectivement en (x, y), avec les paramètres d’ width et d’ height fournis, en utilisant la fonction painter fournie.

La valeur fournie palette spécifie les couleurs d’ombrage (light, dark et middle ). La valeur fournie lineWidth spécifie la largeur de chaque ligne ; il ne s’agit pas de la largeur totale des lignes. La valeur 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 en relief.

Avertissement : cette fonction ne tient pas compte des fonctions ` QWidget::style()` ni ` QApplication::style()`. Utilisez les fonctions de dessin de ` QStyle ` pour créer des widgets conformes au 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é défini par rect à l'aide de l'painter fournie.

L'palette fournie spécifie les couleurs de remplissage (light, dark et middle ). L'lineWidth fournie spécifie la largeur de chaque ligne ; il ne s'agit pas de la largeur totale des lignes. L'midLineWidth spécifie la largeur d'une ligne centrale dessiné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 en relief.

Avertissement : cette fonction ne tient pas compte des paramètres QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets respectant 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 également 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 les points indiqués (x, y}, width et height ) à l'aide de l'painter fourni, avec une épaisseur de trait de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill, sauf si fill vaut nullptr.

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

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

Avertissement : cette fonction ne tient pas compte des paramètres QWidget::style() ni QApplication::style() — utilisez les fonctions de dessin de QStyle pour créer des widgets respectant le style actuel de l'interface graphique.

Voir également qDrawWinPanel() et QStyle.

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

Dessine un bouton de style Windows dans le rectangle spécifié par ` rect `, en utilisant le style de bordure ` painter ` fourni, avec une largeur de trait de 2 pixels. L'intérieur du bouton est rempli avec le pinceau ` fill `, sauf si ` fill ` est défini sur ` nullptr`.

La valeur palette spécifie les couleurs d’ombrage (couleurslight, dark et middle ).

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

Avertissement : cette fonction ne tient pas compte de QWidget::style() ni de QApplication::style(). Utilisez les fonctions de dessin de QStyle pour créer des widgets respectant le style actuel de l'interface graphique.

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

Voir également 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 les points indiqués (x, y), width et height, en utilisant l'painter fournie avec une épaisseur de trait de 2 pixels. L'intérieur du bouton est rempli avec le pinceau fill, sauf si fill vaut nullptr.

La valeur palette spécifie les couleurs d’ombrage. Le panneau apparaît en creux si sunken est vrai, sinon il apparaît en relief.

Avertissement : cette fonction ne tient pas compte de QWidget::style() ni de QApplication::style(). Utilisez les fonctions de dessin disponibles à l’adresse QStyle pour créer des widgets respectant 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 un panneau de style Windows dans le rectangle spécifié par ` rect `, en utilisant le style de ligne ` painter ` donné, avec une largeur de ligne de 2 pixels. L'intérieur du bouton est rempli avec le pinceau ` fill `, sauf si ` fill ` est défini sur ` nullptr`.

La valeur palette fournie spécifie les couleurs d'ombrage. Le panneau apparaît en creux si sunken est vrai, sinon en relief.

Avertissement : cette fonction ne tient pas compte des fonctions QWidget::style() ni QApplication::style(). Utilisez les fonctions de dessin disponibles à l’adresse QStyle pour créer des widgets respectant 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.