QBrush(3qt)QBrush(3qt)NAME
QBrush - Defines the fill pattern of shapes drawn by a
#include <qbrush.h>
Inherits Qt.
Public Members
QBrush ()
QBrush ( BrushStyle )
QBrush ( const QColor &, BrushStyle=SolidPattern )
QBrush ( const QColor &, const QPixmap & )
QBrush ( const QBrush & )
~QBrush ()
QBrush& operator= ( const QBrush & )
BrushStyle style () const
void setStyle ( BrushStyle )
const QColor& color () const
void setColor ( const QColor & )
QPixmap* pixmap () const
void setPixmap ( const QPixmap & )
bool operator== ( const QBrush & p ) const
bool operator!= ( const QBrush & b ) const
RELATED FUNCTION DOCUMENTATION
(Note that these are not member functions.)
QDataStream & operator>> (QDataStream & s, QBrush & b)
QDataStream & operator<< (QDataStream & s, const QBrush &
b)
DESCRIPTION
The QBrush class defines the fill pattern of shapes drawn
by a QPainter.
A brush has a style and a color. One of the brush styles
is a custom pattern, which is defined by a QPixmap.
The brush style defines the fill pattern. The default
brush style is NoBrush (depends on how you construct a
brush). This style tells the painter to not fill shapes.
The standard style for filling is called SolidPattern.
The brush color defines the color of the fill pattern. The
QColor documentation lists the predefined colors.
Use the QPen class for specifying line/outline styles.
Example:
QPainter painter;
QBrush brush( yellow ); // yellow solid pattern
painter.begin( &anyPaintDevice ); // paint something
painter.setBrush( brush ); // set the yellow brush
Trolltech AS 13 June 2001 1
QBrush(3qt)QBrush(3qt)
painter.setPen( NoPen ); // do not draw outline
painter.drawRect( 40,30, 200,100 ); // draw filled rectangle
painter.setBrush( NoBrush ); // do not fill
painter.setPen( black ); // set black pen, 0 pixel width
painter.drawRect( 10,10, 30,20 ); // draw rectangle outline
painter.end(); // painting done
See the setStyle() function for a complete list of brush
styles.
See also QPainter, QPainter::setBrush() and
QPainter::setBrushOrigin().
Examples: drawdemo/drawdemo.cpp picture/picture.cpp
MEMBER FUNCTION DOCUMENTATIONQBrush::QBrush ()
Constructs a default black brush with the style NoBrush
(will not fill shapes).
QBrush::QBrush ( BrushStyle style )
Constructs a black brush with the specified style.
See also setStyle().
QBrush::QBrush ( const QColor & color, BrushStyle
style=SolidPattern )
Constructs a brush with a specified color and style.
See also setColor() and setStyle().
QBrush::QBrush ( const QColor & color, const QPixmap & pixmap )
Constructs a brush with a specified color and a custom
pattern.
The color will only have an effect for monochrome pixmaps,
i.e. QPixmap::depth() == 1.
See also setColor() and setPixmap().
QBrush::QBrush ( const QBrush & b )
Constructs a brush which is a shallow copy of b.
QBrush::~QBrush ()
Destructs the brush.
const QColor & QBrush::color () const
Returns the brush color.
See also setColor().
bool QBrush::operator!= ( const QBrush & b ) const
Returns TRUE if the brush is different from b, or FALSE if
the brushes are equal.
Trolltech AS 13 June 2001 2
QBrush(3qt)QBrush(3qt)
Two brushes are different if they have different styles,
colors or pixmaps.
See also operator==().
QBrush & QBrush::operator= ( const QBrush & b )
Assigns b to this brush and returns a reference to this
brush.
bool QBrush::operator== ( const QBrush & b ) const
Returns TRUE if the brush is equal to b, or FALSE if the
brushes are different.
Two brushes are equal if they have equal styles, colors
and pixmaps.
See also operator!=().
QPixmap * QBrush::pixmap () const
Returns a pointer to the custom brush pattern.
A null pointer is returned if no custom brush pattern has
been set.
See also setPixmap().
void QBrush::setColor ( const QColor & c )
Sets the brush color to c.
See also color() and setStyle().
Examples: picture/picture.cpp
void QBrush::setPixmap ( const QPixmap & pixmap )
Sets the brush pixmap. The style is set to CustomPattern.
The current brush color will only have an effect for
monochrome pixmaps, i.e. QPixmap::depth() == 1.
See also pixmap() and color().
void QBrush::setStyle ( BrushStyle s )
Sets the brush style to s.
The brush styles are:
NoBrush will not fill shapes (default).
SolidPattern solid (100%) fill pattern.
Dense1Pattern 94% fill pattern.
Dense2Pattern 88% fill pattern.
Trolltech AS 13 June 2001 3
QBrush(3qt)QBrush(3qt)
Dense3Pattern 63% fill pattern.
Dense4Pattern 50% fill pattern.
Dense5Pattern 37% fill pattern.
Dense6Pattern 12% fill pattern.
Dense7Pattern 6% fill pattern.
HorPattern horizontal lines pattern.
VerPattern vertical lines pattern.
CrossPattern crossing lines pattern.
BDiagPattern diagonal lines (directed / ) pattern.
FDiagPattern diagonal lines (directed \ ) pattern.
DiagCrossPattern diagonal crossing lines pattern.
CustomPattern set when a pixmap pattern is being used.
See also style().
BrushStyle QBrush::style () const
Returns the brush style.
See also setStyle().
RELATED FUNCTION DOCUMENTATIONQDataStream & operator>> (QDataStream & s, QBrush & b)
Reads a brush from the stream and returns a reference to
the stream.
See also Format of the QDataStream operators
QDataStream & operator<;< (QDataStream & s, const QBrush & b)
Writes a brush to the stream and returns a reference to
the stream.
See also Format of the QDataStream operators
SEE ALSO
http://doc.trolltech.com/qbrush.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
Trolltech AS 13 June 2001 4
QBrush(3qt)QBrush(3qt)AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page (qbrush.3qt)
and the Qt version (2.3.1).
Trolltech AS 13 June 2001 5
