Qt Reference Documentation

# QDecorationDefault Class Reference

The QDecorationDefault class is a base class providing default window decorations. More...

     #include <QDecorationDefault>

Inherits: QDecoration.

This class was introduced in Qt 4.4.

- List of all members, including inherited members

## Public Functions

| QDecorationDefault ()
virtual | ~QDecorationDefault ()

## Reimplemented Public Functions

virtual bool | paint ( QPainter * painter, const QWidget * widget, int decorationRegion = All, DecorationState state = Normal )
virtual QRegion | region ( const QWidget * widget, const QRect & rect, int decorationRegion = All )

- 8 public functions inherited from QDecoration

## Protected Functions

virtual void | paintButton ( QPainter * painter, const QWidget * widget, int buttonRegion, DecorationState state, const QPalette & palette )
virtual QPixmap | pixmapFor ( const QWidget * widget, int decorationRegion, int & xoff, int & yoff )
virtual int | titleBarHeight ( const QWidget * widget )
virtual const char ** | xpmForRegion ( int region )

### Additional Inherited Members

- 2 static public members inherited from QDecoration

## Detailed Description

The QDecorationDefault class is a base class providing default window decorations.

See the documentation for class QDecoration for a detailed description. This subclass of QDecoration provides standard icons for the decoration regions.

Note that this class is non-portable and only available in Qt for Embedded Linux.

## Member Function Documentation

### QDecorationDefault::QDecorationDefault ()

Default constructor.

### QDecorationDefault::~QDecorationDefault ()`[virtual]`

The constructor deletes the static pixmaps.

### bool QDecorationDefault::paint ( QPainter * painter, const QWidget * widget, int decorationRegion = All, DecorationState state = Normal )`[virtual]`

Reimplemented from QDecoration::paint().

Paints the border and title decoration for the top-level widget using the painter provided and the decoration state. The value of decorationRegion is a combination of the bitmask values of enum DecorationRegion.

Note that Qt for Embedded Linux expects this function to return true if any of the widget's decorations are repainted; otherwise it returns false.

### void QDecorationDefault::paintButton ( QPainter * painter, const QWidget * widget, int buttonRegion, DecorationState state, const QPalette & palette )`[virtual protected]`

Paints a region of the top-level widget. The region is painted in the specified decoration state using the painter and palette provided. The region to be painted is specified by buttonRegion, which is a combination of the bitmask values of DecorationRegion. If the value of buttonRegion is one of Help, Menu, Close, Minimize, Maximize, and Normalize, the button pixmap for that region is painted.

See also pixmapFor().

### QPixmap QDecorationDefault::pixmapFor ( const QWidget * widget, int decorationRegion, int & xoff, int & yoff )`[virtual protected]`

Returns a pointer to the QPixmap for the widget specified by widget and decorationRegion. The returned QPixmap is constructed from the default X pixmap obtained from xpmForRegion().

xoff and yoff specify the offset for the pixmap.

The value of decorationRegion must be one of a subset of the values of enum DecorationRegion. The supported values are Help, Menu, Close, Minimize, Maximize, and Normalize. Other values of decorationRegion return 0.

See also QDecoration::DecorationRegion.

### QRegion QDecorationDefault::region ( const QWidget * widget, const QRect & rect, int decorationRegion = All )`[virtual]`

Reimplemented from QDecoration::region().

Returns the region specified by decorationRegion for the top-level widget. rect specifies the rectangle the decoration wraps. The value of decorationRegion is a combination of the bitmask values of enum DecorationRegion.

### int QDecorationDefault::titleBarHeight ( const QWidget * widget )`[virtual protected]`

Returns the title bar height in pixels for the given widget. It is the greater of 20, or the sum of the application font's line spacing value plus a border width fudge factor.

### const char ** QDecorationDefault::xpmForRegion ( int region )`[virtual protected]`

Returns a pointer to the X pixmap for the icon specified by region. An X pixmap is an ASCII-text-based image. The value of region must be one of a subset of the values of enum DecorationRegion. The supported values are Help, Menu, Close, Minimize, Maximize, and Normalize. Other values of region cause zero to be returned.

See also QDecoration::DecorationRegion.