QDecoration Class Reference
^{[QtGui module]}

Detailed Description

The QDecoration class allows the appearance of the Qt/Embedded Window Manager to be customized.

Qt/Embedded provides window management to top level windows. The appearance of the borders and buttons (the decoration) around the managed windows can be customized by creating your own class derived from QDecoration and overriding a few methods.

This class is non-portable. It is available only in Qt/Embedded.

See also QApplication::qwsSetDecoration().

Member Type Documentation

enum QDecoration::DecorationRegion

This enum describes the regions in the window decorations.

enum QDecoration::DecorationState

Member Function Documentation

QDecoration::QDecoration ()

Constructs a decorator.

QDecoration::~QDecoration ()   [virtual]

Destroys a decorator.

void QDecoration::buildSysMenu ( QWidget * widget, QMenu * menu )   [virtual]

Builds the system menu for the TLW widget.

void QDecoration::menuTriggered ( QWidget * widget, QAction * action )

This function is called whenever an action in a menu is triggered for a top level widget.

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

Override to paint the border and title decoration around widget using painter. decorationRegion is the number of the decoration region. state specifies how to render the region.

QRegion QDecoration::region ( const QWidget * w, const QRect & rect, int decorationRegion = All )   [pure virtual]

QRegion QDecoration::region ( const QWidget * widget, int decorationRegion = All )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Returns the requested region decorationRegion which will contain widget.

int QDecoration::regionAt ( const QWidget * widget, const QPoint & point )   [virtual]

Returns the first region within widget which contains point. If none of the regions contain the point, returns None.

void QDecoration::regionClicked ( QWidget * widget, int reg )   [virtual]

This function is called whenever a region in a top level widget is clicked. The widget and region are specified by widget and reg.

The default implementation performs the action for when a region is clicked, and it is used to handle clicks on items in the system menu.

void QDecoration::regionDoubleClicked ( QWidget * widget, int reg )   [virtual]

This function is called whenever a region in a top level widget is double clicked. The widget and region are specified by widget and reg.

The default implementation responds to a double click on the widget's title, toggling its size between the maximum and its normal size.

void QDecoration::startMove ( QWidget * widget )   [static]

Initiates move mode for the top level widget specified by widget that is TLW handled by QWSManager.

void QDecoration::startResize ( QWidget * widget )   [static]

Initiates resize mode for the top level widget specified by widget that is handled by QWSManager.