QBrush Class
La classe QBrush définit le motif de remplissage des formes dessinées par QPainter. En savoir plus...
| En-tête : | #include <QBrush> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- QBrush fait partie des classes de peinture et des classes implicitement partagées.
Fonctions publiques
| QBrush() | |
| QBrush(Qt::BrushStyle style) | |
| QBrush(const QGradient &gradient) | |
| QBrush(const QImage &image) | |
| QBrush(const QPixmap &pixmap) | |
| QBrush(Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern) | |
| QBrush(Qt::GlobalColor color, const QPixmap &pixmap) | |
| QBrush(const QColor &color, Qt::BrushStyle style = Qt::SolidPattern) | |
| QBrush(const QColor &color, const QPixmap &pixmap) | |
| QBrush(const QBrush &other) | |
| ~QBrush() | |
| const QColor & | color() const |
| const QGradient * | gradient() const |
| bool | isOpaque() const |
| void | setColor(const QColor &color) |
| void | setColor(Qt::GlobalColor color) |
| void | setStyle(Qt::BrushStyle style) |
| void | setTexture(const QPixmap &pixmap) |
| void | setTextureImage(const QImage &image) |
| void | setTransform(const QTransform &matrix) |
| Qt::BrushStyle | style() const |
| void | swap(QBrush &other) |
| QPixmap | texture() const |
| QImage | textureImage() const |
| QTransform | transform() const |
| operator QVariant() const | |
| bool | operator!=(const QBrush &brush) const |
| QBrush & | operator=(QBrush &&other) |
| QBrush & | operator=(const QBrush &brush) |
(since 6.9) QBrush & | operator=(QColor color) |
(since 6.9) QBrush & | operator=(Qt::BrushStyle style) |
(since 6.9) QBrush & | operator=(Qt::GlobalColor color) |
| bool | operator==(const QBrush &brush) const |
Éléments non membres associés
| QDataStream & | operator<<(QDataStream &stream, const QBrush &brush) |
| QDataStream & | operator>>(QDataStream &stream, QBrush &brush) |
Description détaillée
Un pinceau possède un style, une couleur, un dégradé et une texture.
La méthode ` style()` du pinceau définit le motif de remplissage à l’aide de l’énumération ` Qt::BrushStyle `. Le style par défaut du pinceau est ` Qt::NoBrush ` (selon la manière dont vous créez le pinceau). Ce style indique au peintre de ne pas remplir les formes. Le style standard de remplissage est Qt::SolidPattern. Le style peut être défini lors de la création du pinceau à l'aide du constructeur approprié ; de plus, la fonction setStyle() permet de modifier le style une fois le pinceau créé.

La méthode color() du pinceau définit la couleur du motif de remplissage. La couleur peut être soit l’une des couleurs prédéfinies de Qt XML, Qt::GlobalColor, soit n’importe quelle autre couleur personnalisée QColor. La couleur actuellement définie peut être récupérée et modifiée à l’aide des fonctions color() et setColor(), respectivement.
La fonction gradient() définit le remplissage en dégradé utilisé lorsque le style actuel est Qt::LinearGradientPattern, Qt::RadialGradientPattern ou Qt::ConicalGradientPattern. Les pinceaux en dégradé sont créés en passant un QGradient comme argument du constructeur lors de la création du QBrush. Qt fournit trois dégradés différents : QLinearGradient, QConicalGradient et QRadialGradient, qui héritent tous de QGradient.
QRadialGradient gradient(50, 50, 50, 50, 50);
gradient.setColorAt(0, QColor::fromRgbF(0, 1, 0, 1));
gradient.setColorAt(1, QColor::fromRgbF(0, 0, 0, 0));
QBrush brush(gradient);La méthode ` texture()` définit la carte de pixels utilisée lorsque le style actuel est ` Qt::TexturePattern`. Vous pouvez créer un pinceau avec une texture en fournissant la carte de pixels lors de la création du pinceau ou en utilisant ` setTexture()`.
Notez que l’application de ` setTexture()` rend ` style()` égal à ` Qt::TexturePattern`, quels que soient les paramètres de style précédents. De plus, l’appel de ` setColor()` n’aura aucun effet si le style est un dégradé. Il en va de même si le style est de type ` Qt::TexturePattern `, sauf si la texture actuelle est de type ` QBitmap`.
La fonction ` isOpaque()` renvoie ` true ` si le pinceau est entièrement opaque, sinon `false`. Un pinceau est considéré comme opaque si :
- La composante alpha de l’ color() est égale à 255.
- Son image de fond ( texture()) ne comporte pas de canal alpha et n’est pas une image de fond en mode « QBitmap ».
- Les couleurs de l’ gradient() ont toutes une composante alpha égale à 255.
![]() | Pour définir le style et la couleur des lignes et des contours, utilisez l’option « pen » de l’ QPainter en combinaison avec « Qt::PenStyle » et « Qt::GlobalColor » :Notez que, par défaut, QPainter affiche le contour (à l’aide du stylo actuellement sélectionné) lors du tracé de formes. Utilisez |
Pour plus d’informations sur le dessin en général, consultez la section Système de dessin.
Voir également Qt::BrushStyle, QPainter et QColor.
Documentation des fonctions membres
QBrush::QBrush()
Crée un pinceau noir par défaut avec le style « Qt::NoBrush » (c'est-à-dire que ce pinceau ne remplira pas les formes).
QBrush::QBrush(Qt::BrushStyle style)
Crée un pinceau noir avec l'style on fournie.
Voir aussi setStyle().
QBrush::QBrush(const QGradient &gradient)
Crée un pinceau en fonction du style de dégradé spécifié dans gradient.
Le style du pinceau est défini selon le style de dégradé correspondant ( Qt::LinearGradientPattern, Qt::RadialGradientPattern ou Qt::ConicalGradientPattern).
QBrush::QBrush(const QImage &image)
Crée un pinceau de couleur noire dont la texture est définie selon l'adresse image. Le style est défini sur Qt::TexturePattern.
Voir également setTextureImage().
QBrush::QBrush(const QPixmap &pixmap)
Crée un pinceau de couleur noire dont la texture correspond à celle indiquée à l'adresse pixmap. Le style est défini sur Qt::TexturePattern.
Voir également setTexture().
QBrush::QBrush(Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern)
Crée un pinceau à partir des paramètres color et style fournis.
Voir également setColor() et setStyle().
QBrush::QBrush(Qt::GlobalColor color, const QPixmap &pixmap)
Crée un pinceau avec l’ color spécifiée et le motif personnalisé stocké dans pixmap.
Le style est défini sur ` Qt::TexturePattern`. La couleur n'aura d'effet que pour les QBitmaps.
Voir également setColor() et setTexture().
QBrush::QBrush(const QColor &color, Qt::BrushStyle style = Qt::SolidPattern)
Crée un pinceau à partir des paramètres color et style fournis.
Voir également setColor() et setStyle().
QBrush::QBrush(const QColor &color, const QPixmap &pixmap)
Crée un pinceau avec l'color spécifiée et le motif personnalisé stocké dans pixmap.
Le style est défini sur ` Qt::TexturePattern`. La couleur n’aura d’effet que pour les QBitmaps.
Voir également setColor() et setTexture().
QBrush::QBrush(const QBrush &other)
Crée une copie de other.
[noexcept] QBrush::~QBrush()
Détruit le pinceau.
const QColor &QBrush::color() const
Renvoie la couleur du pinceau.
Voir aussi setColor().
const QGradient *QBrush::gradient() const
Renvoie le dégradé caractérisant ce pinceau.
bool QBrush::isOpaque() const
Renvoie ` true ` si le pinceau est entièrement opaque, sinon `false`. Un pinceau est considéré comme opaque si :
- La composante alpha de l'color() est égale à 255.
- Son texture() ne comporte pas de canal alpha et n'est pas un QBitmap.
- Les couleurs de l’ gradient() ont toutes une composante alpha égale à 255.
- Il s'agit d'un dégradé radial étendu.
void QBrush::setColor(const QColor &color)
Définit la couleur du pinceau sur la valeur indiquée color.
Notez que l'appel à setColor() n'aura aucun effet si le style est un dégradé. Il en va de même si le style est de type « Qt::TexturePattern », sauf si la texture actuelle est de type « QBitmap ».
Voir également color().
void QBrush::setColor(Qt::GlobalColor color)
Définit la couleur du pinceau sur la valeur indiquée : color.
Il s’agit d’une fonction surchargée.
void QBrush::setStyle(Qt::BrushStyle style)
Définit le style de pinceau sur « style ».
Voir aussi style().
void QBrush::setTexture(const QPixmap &pixmap)
Définit l'image de type pixmap du pinceau sur pixmap. Le style est défini sur Qt::TexturePattern.
La couleur actuelle du pinceau n'aura d'effet que pour les images monochromes, c'est-à-dire lorsque QPixmap::depth() == 1 (QBitmaps).
Voir également texture().
void QBrush::setTextureImage(const QImage &image)
Définit l'image du pinceau sur image. Le style est défini sur Qt::TexturePattern.
Notez que la couleur actuelle du pinceau n’ aura aucun effet sur les images monochromes, contrairement à l’appel de la fonction setTexture() avec une valeur de QBitmap. Si vous souhaitez modifier la couleur des pinceaux d’images monochromes, vous pouvez soit convertir l’image en QBitmap à l’aide de la fonction QBitmap::fromImage() et définir l’ QBitmap obtenue comme texture, soit modifier les entrées de la table de couleurs de l’image.
Voir également textureImage() et setTexture().
void QBrush::setTransform(const QTransform &matrix)
Définit matrix comme matrice de transformation explicite pour le pinceau actuel. La matrice de transformation du pinceau est fusionnée avec la matrice de transformation QPainter pour produire le résultat final.
Voir également transform().
Qt::BrushStyle QBrush::style() const
Renvoie le style du pinceau.
Voir aussi setStyle().
[noexcept] void QBrush::swap(QBrush &other)
Remplacez ce pinceau par other. Cette opération est très rapide et fonctionne à coup sûr.
QPixmap QBrush::texture() const
Renvoie le motif de pinceau personnalisé, ou une image nulle si aucun motif de pinceau personnalisé n'a été défini.
Voir également setTexture().
QImage QBrush::textureImage() const
Renvoie le motif de pinceau personnalisé, ou une image nulle si aucun motif de pinceau personnalisé n'a été défini.
Si la texture a été définie au format « QPixmap », elle sera convertie au format « QImage ».
Voir également setTextureImage().
QTransform QBrush::transform() const
Renvoie la matrice de transformation actuelle du pinceau.
Voir également setTransform().
QBrush::operator QVariant() const
Renvoie le pinceau sous la forme d'un QVariant
bool QBrush::operator!=(const QBrush &brush) const
Renvoie « true » si le pinceau est différent de celui indiqué par « brush » ; sinon, renvoie « false ».
Deux pinceaux sont différents s’ils ont des styles, des couleurs ou des transformations différents, ou encore des images bitmap ou des dégradés différents selon le style.
Voir également operator==().
[noexcept] QBrush &QBrush::operator=(QBrush &&other)
Cette opération attribue l'other à cette instance de QBrush.
QBrush &QBrush::operator=(const QBrush &brush)
Attribue l'brush on indiquée à ce pinceau et renvoie une référence à ce pinceau.
[since 6.9] QBrush &QBrush::operator=(QColor color)
[since 6.9] QBrush &QBrush::operator=(Qt::GlobalColor color)
Transforme ce pinceau en un pinceau à motif uni selon l'color, et renvoie une référence à ce pinceau.
Ces fonctions ont été introduites dans Qt 6.9.
[since 6.9] QBrush &QBrush::operator=(Qt::BrushStyle style)
Transforme ce pinceau en un pinceau noir de l'style spécifiée, et renvoie une référence à ce pinceau.
Il s'agit d'une fonction surchargée.
Cette fonction a été introduite dans Qt 6.9.
bool QBrush::operator==(const QBrush &brush) const
Renvoie « true » si le pinceau est identique à celui spécifié par « brush » ; sinon, renvoie « false ».
Deux pinceaux sont égaux s’ils ont les mêmes styles, couleurs et transformations, ainsi que les mêmes images bitmap ou dégradés selon le style.
Voir aussi operator!=().
Éléments non membres associés
QDataStream &operator<<(QDataStream &stream, const QBrush &brush)
Écrit l'brush on indiquée dans l'stream on indiquée et renvoie une référence à l'stream on.
Voir également Sérialisation des types de données Qt.
QDataStream &operator>>(QDataStream &stream, QBrush &brush)
Lit l'brush on fournie à partir de l'stream on indiquée et renvoie une référence vers l'stream on.
Voir également Sérialisation des types de données Qt.
© 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.
