QBrush Class Reference

Detailed 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 (depending on how you construct a brush). This style tells the painter to not fill shapes. The standard style for filling is 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
        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(), QPainter::setBrushOrigin(), Graphics Classes, Image Processing Classes, and Implicitly and Explicitly Shared Classes.

Member Function Documentation

QBrush::QBrush ()

QBrush::QBrush ( BrushStyle style )

See also setStyle().

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

See also setColor() and setStyle().

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

The color will only have an effect for monochrome pixmaps, i.e. for QPixmap::depth() == 1.

Pixmap brushes are currently not supported when printing on X11.

See also setColor() and setPixmap().

QBrush::QBrush ( const QBrush & b )

QBrush::~QBrush ()

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; otherwise returns FALSE.

Two brushes are different if they have different styles, colors or pixmaps.

See also operator==().

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

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

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, or 0 if no custom brush pattern has been set.

See also setPixmap().

Example: richtext/richtext.cpp.

void QBrush::setColor ( const QColor & c )

See also color() and setStyle().

Example: picture/picture.cpp.

void QBrush::setPixmap ( const QPixmap & pixmap )

The current brush color will only have an effect for monochrome pixmaps, i.e. for QPixmap::depth() == 1.

Pixmap brushes are currently not supported when printing on X11.

See also pixmap() and color().

Example: richtext/richtext.cpp.

void QBrush::setStyle ( BrushStyle s )

The brush styles are:

On Windows, dense and custom patterns cannot be transparent.

See the Detailed Description for a picture of all the styles.

See also style().

BrushStyle QBrush::style () const

Returns the brush style.

See also setStyle().

Related Functions

QDataStream & operator<< ( QDataStream & s, const QBrush & b )

Writes the brush b to the stream s and returns a reference to the stream.

See also Format of the QDataStream operators.

QDataStream & operator>> ( QDataStream & s, QBrush & b )

Reads the brush b from the stream s and returns a reference to the stream.

See also Format of the QDataStream operators.

This file is part of the Qt toolkit. Copyright © 1995-2005 Trolltech. All Rights Reserved.