QDecoration Class Reference

Member Function Documentation

QDecoration::QDecoration ()

Constructs a decoration object.

QDecoration::~QDecoration () [virtual]

Destroys this decoration object.

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

Builds the system menu for the given top level widget, adding Restore, Move, Size, Minimize, Maximize and Close actions to the given menu.

See also menuTriggered().

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

This function is called whenever an action in a top level widget's menu is triggered, and simply calls the regionClicked() function passing the widget and action parameters as arguments.

See also buildSysMenu().

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

Implement this function to paint the border and title decoration for the specified top level widget using the given painter and decoration state. The specified decorationRegion is a bitmask of the values described by the DecorationRegion enum.

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

See also region().

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

Implement this function to return the region specified by decorationRegion for the given top level widget.

The rectangle parameter specifies the rectangle the decoration is wrapped around. The decorationRegion is a bitmask of the values described by the DecorationRegion enum.

See also regionAt() and paint().

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

This is an overloaded function.

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

Returns the type of the first region of the specified top level widget containing the given point.

The return value is one of the DecorationRegion enum's values. Use the region() function to retrieve the actual region. If none of the widget's regions contain the point, this function returns None.

See also region().

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

Handles the event that the specified region in the given top level widget is activated by a single click (the region parameter is described using the DecorationRegion enum).

This function is called whenever a region in a top level widget is clicked; the default implementation responds to clicks on items in the system menu, performing the requested actions.

See also regionDoubleClicked() and region().

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

Handles the event that the specified region in the given top level widget is activated by a double click (the region parameter is described using the DecorationRegion enum).

This function is called whenever a region in a top level widget is double clicked; the default implementation responds to a double click on the widget's title, toggling its size between the maximum and its normal size.

See also regionClicked() and region().

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

Starts to move the given top level widget by making its Title region active and grabbing the mouse input.

See also startResize().

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

Starts to resize the given top level widget by making its BottomRight region active and grabbing the mouse input.

See also startMove().