qbrush.3qt

Langue: en

Version: 2 February 2007 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

QBrush - Defines the fill pattern of shapes drawn by a QPainter

SYNOPSIS

#include <qbrush.h>

Inherits Qt.

Public Members


QBrush ()

QBrush ( BrushStyle style )

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

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

QBrush ( const QBrush & b )

~QBrush ()

QBrush & operator= ( const QBrush & b )

BrushStyle style () const

void setStyle ( BrushStyle s )

const QColor & color () const

void setColor ( const QColor & c )

QPixmap * pixmap () const

void setPixmap ( const QPixmap & pixmap )

bool operator== ( const QBrush & b ) const

bool operator!= ( const QBrush & b ) const

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

QDataStream & operator>> ( QDataStream & s, 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 (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.

<center>

[Image Omitted]

</center>

See also QPainter, QPainter::setBrush(), QPainter::setBrushOrigin(), Graphics Classes, Image Processing Classes, and Implicitly and Explicitly Shared Classes.

MEMBER FUNCTION DOCUMENTATION

QBrush::QBrush ()

Constructs a default black brush with the style NoBrush (will not fill shapes).

QBrush::QBrush ( BrushStyle style )

Constructs a black brush with the style style.

See also setStyle().

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

Constructs a brush with the color color and the style style.

See also setColor() and setStyle().

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

Constructs a brush with the color color and a custom pattern stored in 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 )

Constructs a brush that is a shallow copy of b.

QBrush::~QBrush ()

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

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

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 )

Sets the brush color to c.

See also color() and setStyle().

Example: picture/picture.cpp.

void QBrush::setPixmap ( const QPixmap & pixmap )

Sets the brush pixmap to pixmap. The style is set to CustomPattern.

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 )

Sets the brush style to s.

The brush styles are: <center>.nf

                                                                 
</center>

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().

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.

SEE ALSO

http://doc.trolltech.com/qbrush.html http://www.trolltech.com/faq/tech.html Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

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 help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in 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 (3.3.8).