QBrush

La classe QBrush définit le motif de remplissage des formes dessinées par QPainter. Plus d'informations...

#include <QBrush>

Voir la position dans l'arbre des classes.

Description détaillée

La classe QBrush définit le motif de remplissage des formes dessinées par QPainter.

Une brosse a un style, une couleur, un gradient et une texture.

La brosse style() définit le motif de remplissage en utilisant l'énumération Qt::BrushStyle. Le style de brosse par défaut est Qt::NoBrush. Ce style indique au QPainter de ne pas remplir les formes. Le style standard de remplissage est Qt::SolidPattern. Le style peut être spécifié lorsque la brosse est créée en utilisant le constructeur approprié et la fonction setStyle() fournit un moyen supplémentaire de modification du style après que la brosse eût été créée.

La brosse color() définit la couleur du motif de remplissage. La couleur peut être soit une des couleurs prédéfinies de Qt, Qt::GlobalColor ou une QColor personnalisée. La couleur actuelle peut être lue et modifiée en utilisant respectivement les fonctions color() et setColor().

Le gradient() définit le gradient de remplissage utilisé lorsque le style courant est soit Qt::LinearGradientPattern, Qt::RadialGradientPattern ou Qt::ConicalGradientPattern. Les brosses gradient sont créées en passant un QGradient comme argument du constructeur à la création de la QBrush. Qt fournit trois gradients différents : QLinearGradient, QConicalGradient et QRadialGradient - qui dérivent 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 texture() définit la pixmap utilisée lorsque le style courant est Qt::TexturePattern. Vous pouvez créer une brosse avec une texture en fournissant la pixmap lorsque la brosse est créée ou en utilisant setTexture().

Notez que l'application de setTexture() fait que style() == Qt::TexturePattern, indépendamment des paramètres de style précédents. Notez également que setColor() n'aura pas d'effet si le style est un gradient, de même si le style est Qt::TexturePattern sauf si la texture courante est une QBitmap.

La fonction isOpaque() renvoie true si la brosse est complètement opaque, sinon false. Une brosse est considérée opaque si :

• la composante alpha de color() est 255 ;
• la texture() n'a pas de canal alpha et n'est pas une QBitmap ;
• les couleurs dans le gradient() ont toutes une composante alpha de 255.

Pour spécifier le style et la couleur des lignes et des contours, utilisez le pinceau de QPainter combiné avec Qt::PenStyle et Qt::GlobalColor :

QPainter painter(this);   painter.setBrush(Qt::cyan); painter.setPen(Qt::darkCyan); painter.drawRect(0, 0, 100,100);   painter.setBrush(Qt::NoBrush); painter.setPen(Qt::darkGreen); painter.drawRect(40, 40, 100, 100);

Notez que, par défaut, QPainter dessine le contour (en utilisant le pinceau courant) lorsqu'il dessine les formes. Utilisez PenStyle pour désactiver ce comportement.

Pour plus d'informations sur le dessin en général, voir le système de dessin.

Voir aussi Qt::BrushStyle, QPainter et QColor.

Fonctions membres

QBrush::QBrush ()

Construit une brosse noire par défaut avec le style Qt::NoBrush (c'est-à-dire que cette brosse ne remplira pas les formes).

QBrush::QBrush ( Qt::BrushStyle style )

Construit une brosse noire avec le style donné.

Voir aussi setStyle().

QBrush::QBrush ( const QColor & color, Qt::BrushStyle style = Qt::SolidPattern )

Construit une brosse avec la couleur et le style donnés.

Voir aussi setColor() et setStyle().

QBrush::QBrush ( Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern )

Construit une brosse avec la couleur et le style donnés.

Voir aussi setColor() et setStyle().

QBrush::QBrush ( const QColor & color, const QPixmap & pixmap )

Construit une brosse avec la couleur donnée et le motif personnalisé stocké dans pixmap.

Le style prend la valeur Qt::TexturePattern. La couleur a un effet seulement pour les QBitmaps.

Voir aussi setColor() et setPixmap().

QBrush::QBrush ( Qt::GlobalColor color, const QPixmap & pixmap )

Construit une brosse avec la couleur donnée et le motif personnalisé stocké dans pixmap.

Le style prend la valeur Qt::TexturePattern. La couleur a un effet seulement pour les QBitmaps.

Voir aussi setColor() et setPixmap().

QBrush::QBrush ( const QPixmap & pixmap )

Construit une brosse de couleur noire et comme texture la pixmap donnée. Le style prend la valeur Qt::TexturePattern.

Voir aussi setTexture().

QBrush::QBrush ( const QImage & image )

Construit une brosse de couleur noire et comme texture la pixmap donnée. Le style prend la valeur Qt::TexturePattern.

Voir aussi setTextureImage().

QBrush::QBrush ( const QBrush & other )

Construit une copie de other.

QBrush::QBrush ( const QGradient & gradient )

Construit une brosse basée sur le gradient donné.

Le style de brosse est défini en fonction du style de gradient (Qt::LinearGradientPattern, Qt::RadialGradientPattern ou Qt::ConicalGradientPattern).

QBrush::~QBrush ()

Détruit la brosse.

const QColor & QBrush::color () const

Renvoie la couleur de la brosse.

Voir aussi setColor().

const QGradient * QBrush::gradient () const

Renvoie le gradient décrivant cette brosse.

bool QBrush::isOpaque () const

Renvoie true si la brosse est totalement opaque, sinon false. Une brosse est considérée opaque si :

• la composante alpha de color() vaut 255 ;
• sa texture() n'a pas de canal alpha et n'est pas une QBitmap ;
• les couleurs du gradient() ont toutes des composantes alpha de 255.

const QMatrix & QBrush::matrix () const

Renvoie la matrice de transformation de la brosse.

Cette fonction a été introduite dans Qt 4.2.

Voir aussi setMatrix().

void QBrush::setColor ( const QColor & color )

Fixe la couleur de la brosse à la couleur color donnée.

Notez que l'appel de setColor() n'aura pas d'effet si le style est un gradient. De même si le style est Qt::TexturePattern sauf si la texture courante est une QBitmap.

Voir aussi color().

void QBrush::setColor ( Qt::GlobalColor color )

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

Fixe la couleur de la brosse à la couleur color donnée.

void QBrush::setMatrix ( const QMatrix & matrix )

Spécifie matrix comme matrice de transformation explicite sur la brosse. La matrice de transformation de la brosse est fusionnée avec la matrice de transformation du QPainter pour produire le résultat final.

Cette fonction a été introduite dans Qt 4.2.

Voir aussi matrix().

void QBrush::setStyle ( Qt::BrushStyle style )

Fixe le style de la brosse à la valeur style.

Voir aussi style().

void QBrush::setTexture ( const QPixmap & pixmap )

Spécifie pixmap comme pixmap de la brosse. Le style devient Qt::TexturePattern.

La couleur de brosse courante n'aura d'effet que pour les pixmaps monochromes, c'est-à-dire QPixmap::depth() == 1 (QBitmaps).

Voir aussi texture().

void QBrush::setTextureImage ( const QImage & image )

Spécifie image comme image de la brosse. Le style devient Qt::TexturePattern.

Notez que la couleur de brosse courante n'aura aucun effet sur les images monochromes, contrairement à l'appel de setTexture() avec une QBitmap. Si vous voulez changer la couleur de brosses d'images monochromes, convertissez l'image en QBitmap avec QBitmap::fromImage() et spécifiez la QBitmap résultante comme texture ou changez les entrées de la table des couleurs de l'image.

Cette fonction a été introduite dans Qt 4.2.

Voir aussi textureImage() et setTexture().

void QBrush::setTransform ( const QTransform & matrix )

Spécifie matrix comme matrice de transformation explicite sur la brosse. La matrice de transformation de la brosse est fusionnée avec la matrice de transformation du QPainter pour produire le résultat final.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi transform().

Qt::BrushStyle QBrush::style () const

Renvoie le style de la brosse.

Voir aussi setStyle().

QPixmap QBrush::texture () const

Renvoie le motif de brosse personnalisé ou une pixmap null si aucun motif personnalisé n'a été défini.

Voir aussi setTexture().

QImage QBrush::textureImage () const

Renvoie le motif de brosse personnalisé ou une image null si aucun motif personnalisé n'a été défini.

Si la texture a été définie avec une QPixmap elle sera convertie en QImage.

Cette fonction a été introduite dans Qt 4.2.

Voir aussi setTextureImage().

QTransform QBrush::transform () const

Renvoie la matrice de transformation courante de la brosse.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi setTransform().

QBrush::operator QVariant () const

Renvoie la brosse sous forme d'un QVariant

bool QBrush::operator!= ( const QBrush & brush ) const

Renvoie true si la brosse est différente de la brosse brush donnée ; sinon renvoie false.

Deux brosses sont différentes si elles ont des styles, couleurs ou transformations différents, ou différents pixmaps ou gradients, en fonction du style.

Voir aussi operator==().

QBrush & QBrush::operator= ( const QBrush & brush )

Affecte la brosse brush donnée à l'objet et renvoie une référence à l'objet (this).

bool QBrush::operator== ( const QBrush & brush ) const

Renvoie true si la brosse est égale à la brosse brush donnée ; sinon renvoie false.

Deux brosses sont égales si elles ont des styles, couleurs et transformations identiques, et des pixmaps ou gradients identiques, en fonction du style.

Voir aussi operator!=().

En relation mais non membres de la classe

QDataStream & operator<< ( QDataStream & stream, const QBrush & brush )

Écrit la brosse brush donnée dans le flux stream donné et renvoie une référence à stream.

Voir aussi sérialisation des types de données Qt.

QDataStream & operator>> ( QDataStream & stream, QBrush & brush )

Lit la brosse brush donnée depuis le flux stream donné et renvoie une référence à stream.

Voir aussi sérialisation des types de données Qt.

Remerciements

Merci à Ilya Diallo pour la traduction ainsi qu'à Emmanuel Di Clemente, Jonathan Courtois et Claude Leloup pour leur relecture !