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 !