QDecorationWindows Class Reference

#include <qdecorationwindows_qws.h>

Inheritance diagram for QDecorationWindows:

Public Functions
bool	paint (QPainter *painter, const QWidget *widget, int decorationRegion=All, DecorationState state=Normal)
	Paints the border and title decoration for the top-level widget using the painter provided and the decoration state. More...
	QDecorationWindows ()
QRegion	region (const QWidget *widget, const QRect &rect, int decorationRegion=All)
	Returns the region specified by decorationRegion for the top-level widget. More...
virtual	~QDecorationWindows ()
Public Functions inherited from QDecorationDefault
	QDecorationDefault ()
	Default constructor. More...
virtual	~QDecorationDefault ()
	The constructor deletes the static pixmaps. More...
Public Functions inherited from QDecoration
virtual void	buildSysMenu (QWidget *widget, QMenu *menu)
	Builds the system menu for the given top level widget, adding Restore, Move, Size, Minimize, Maximize and Close actions to the given menu. More...
void	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. More...
	QDecoration ()
	Constructs a decoration object. More...
QRegion	region (const QWidget *w, int decorationRegion=All)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More...
virtual int	regionAt (const QWidget *w, const QPoint &point)
	Returns the type of the first region of the specified top level widget containing the given point. More...
virtual void	regionClicked (QWidget *widget, int region)
	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). More...
virtual void	regionDoubleClicked (QWidget *widget, int region)
	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). More...
virtual	~QDecoration ()
	Destroys this decoration object. More...

Protected Functions
void	paintButton (QPainter *painter, const QWidget *widget, int buttonRegion, DecorationState state, const QPalette &pal)
	Paints a region of the top-level widget. More...
const char **	xpmForRegion (int reg)
	Returns a pointer to the X pixmap for the icon specified by region. More...
Protected Functions inherited from QDecorationDefault
virtual QPixmap	pixmapFor (const QWidget *widget, int decorationRegion, int &xoff, int &yoff)
	Returns a pointer to the QPixmap for the widget specified by widget and decorationRegion. More...
virtual int	titleBarHeight (const QWidget *widget)
	Returns the title bar height in pixels for the given widget. More...
QString	windowTitleFor (const QWidget *widget) const

Additional Inherited Members
Public Types inherited from QDecoration
enum	DecorationRegion {   None = 0x0000000000, All = 0x7fffffff, TopLeft = 0x0000000001, Top = 0x0000000002,   TopRight = 0x0000000004, Left = 0x0000000008, Right = 0x0000000010, BottomLeft = 0x0000000020,   Bottom = 0x0000000040, BottomRight = 0x0000000080, Borders = 0x00000000ff, Menu = 0x0000000100,   Title = 0x0000000200, Help = 0x0000000400, Minimize = 0x0000000800, Maximize = 0x0000001000,   Normalize = 0x0000002000, Close = 0x0000004000, Move = 0x0000008000, Resize = 0x0000010000 }
	This enum describes the various regions of the window decoration. More...
enum	DecorationState { Normal = 0x04, Disabled = 0x08, Hover = 0x01, Pressed = 0x02 }
	This enum describes the various states of a decoration region. More...
Static Public Functions inherited from QDecoration
static void	startMove (QWidget *widget)
	Starts to move the given top level widget by making its Title region active and grabbing the mouse input. More...
static void	startResize (QWidget *widget)
	Starts to resize the given top level widget by making its BottomRight region active and grabbing the mouse input. More...
Protected Variables inherited from QDecorationDefault
int	close_width
int	help_width
int	maximize_width
int	menu_width
int	minimize_width
int	normalize_width

Detailed Description

Definition at line 55 of file qdecorationwindows_qws.h.

Constructors and Destructors

QDecorationWindows()

QDecorationWindows::QDecorationWindows

(

)

Definition at line 172 of file qdecorationwindows_qws.cpp.

    : QDecorationDefault()
{
    menu_width = 16;
    help_width = 18;
    minimize_width = 18;
    maximize_width = 18;
    close_width = 18;
}

~QDecorationWindows()

QDecorationWindows::~QDecorationWindows ( )

virtual

Definition at line 182 of file qdecorationwindows_qws.cpp.

{
}

Functions

paint()

bool QDecorationWindows::paint ( QPainter *  painter, const QWidget *  widget, int  decorationRegion = All, DecorationState  state = Normal  )

virtual

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.

Reimplemented from QDecorationDefault.

Definition at line 319 of file qdecorationwindows_qws.cpp.

{
    if (decorationRegion == None)
        return false;

    const QRect titleRect = QDecoration::region(widget, Title).boundingRect();
    const QPalette pal = QApplication::palette();
    QRegion oldClipRegion = painter->clipRegion();

    bool paintAll = (decorationRegion == int(All));
    if ((paintAll || decorationRegion & Title && titleRect.width() > 0) && state == Normal
        && (widget->windowFlags() & Qt::WindowTitleHint) ) {
        painter->setClipRegion(oldClipRegion);
        QColor fromBrush, toBrush;
        QPen   titlePen;

        if (widget == qApp->activeWindow() || qApp->activeWindow() == qApp->activePopupWidget()) {
            fromBrush = pal.color(QPalette::Highlight);
            titlePen  = pal.color(QPalette::HighlightedText);
        } else {
            fromBrush = pal.color(QPalette::Window);
            titlePen  = pal.color(QPalette::Text);
        }
        toBrush = fromBrush.lighter(300);

        painter->setPen(Qt::NoPen);
        QPoint p1(titleRect.x(), titleRect.y() + titleRect.height()/2);
        QPoint p2(titleRect.right(), titleRect.y() + titleRect.height()/2);
        QLinearGradient lg(p1, p2);
        lg.setColorAt(0, fromBrush);
        lg.setColorAt(1, toBrush);
        painter->fillRect(titleRect, lg);

        painter->setPen(titlePen);
        painter->drawText(titleRect, Qt::AlignVCenter, windowTitleFor(widget));
        decorationRegion ^= Title;
    }

    return QDecorationDefault::paint(painter, widget, decorationRegion, state);
}

paintButton()

void QDecorationWindows::paintButton ( QPainter *  painter, const QWidget *  widget, int  buttonRegion, DecorationState  state, const QPalette &  pal  )

protectedvirtual

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

Reimplemented from QDecorationDefault.

Definition at line 361 of file qdecorationwindows_qws.cpp.

{
    QBrush fromBrush, toBrush;
    QPen   titlePen;

    if (widget == qApp->activeWindow() || qApp->activeWindow() == qApp->activePopupWidget()) {
        fromBrush = pal.brush(QPalette::Highlight);
        titlePen  = pal.color(QPalette::HighlightedText);
    } else {
        fromBrush = pal.brush(QPalette::Window);
        titlePen  = pal.color(QPalette::Text);
    }
    toBrush = fromBrush.color().lighter(300);

    QRect brect(QDecoration::region(widget, buttonRegion).boundingRect());
    if (buttonRegion != Close && buttonRegion != Menu)
        painter->fillRect(brect, toBrush);
    else
        painter->fillRect(brect.x() - 2, brect.y(), brect.width() + 4, brect.height(),
                          buttonRegion == Menu ? fromBrush : toBrush);

    int xoff = 1;
    int yoff = 2;
    const QPixmap pm = pixmapFor(widget, buttonRegion, xoff, yoff);
    if (buttonRegion != Menu) {
        if (state & Normal) {
            qDrawWinPanel(painter, brect.x(), brect.y() + 2, brect.width(),
                          brect.height() - 4, pal, false, &pal.brush(QPalette::Window));
        } else if (state & Pressed) {
            qDrawWinPanel(painter, brect.x(), brect.y() + 2, brect.width(),
                          brect.height() - 4, pal, true, &pal.brush(QPalette::Window));
            ++xoff;
            ++yoff;
        }
    } else {
        xoff = 0;
        yoff = 2;
    }

    if (!pm.isNull())
        painter->drawPixmap(brect.x() + xoff, brect.y() + yoff, pm);
}

region()

QRegion QDecorationWindows::region ( const QWidget *  widget, const QRect &  rect, int  decorationRegion = All  )

virtual

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.

Reimplemented from QDecorationDefault.

Definition at line 210 of file qdecorationwindows_qws.cpp.

{
    Qt::WindowFlags flags = widget->windowFlags();
    bool hasTitle = flags & Qt::WindowTitleHint;
    bool hasSysMenu = flags & Qt::WindowSystemMenuHint;
    bool hasContextHelp = flags & Qt::WindowContextHelpButtonHint;
    bool hasMinimize = flags & Qt::WindowMinimizeButtonHint;
    bool hasMaximize = flags & Qt::WindowMaximizeButtonHint;
    const QFontMetrics fontMetrics = QApplication::fontMetrics();
    int titleHeight = hasTitle ? qMax(20, fontMetrics.height()) : 0;
    int state = widget->windowState();
    bool isMinimized = state & Qt::WindowMinimized;
    bool isMaximized = state & Qt::WindowMaximized;

    QRegion region;
    switch (type) {
        case Menu: {
                if (hasSysMenu) {
                    region = QRect(rect.left() + 2, rect.top() - titleHeight,
                                   menu_width, titleHeight);
                }
            }
            break;

        case Title: {
                QRect r(rect.left()
                        + (hasSysMenu ? menu_width + 4: 0),
                        rect.top() - titleHeight,
                        rect.width()
                        - (hasSysMenu ? menu_width : 0)
                        - close_width
                        - (hasMaximize ? maximize_width : 0)
                        - (hasMinimize ? minimize_width : 0)
                        - (hasContextHelp ? help_width : 0)
                        - 3,
                        titleHeight);
                if (r.width() > 0)
                    region = r;
            }
            break;
        case Help: {
                if (hasContextHelp) {
                    QRect r(rect.right()
                            - close_width
                            - (hasMaximize ? maximize_width : 0)
                            - (hasMinimize ? minimize_width : 0)
                            - help_width - 3, rect.top() - titleHeight,
                            help_width, titleHeight);
                    if (r.left() > rect.left() + titleHeight)
                        region = r;
                }
            }
            break;

        case Minimize: {
                if (hasMinimize && !isMinimized) {
                    QRect r(rect.right() - close_width
                            - (hasMaximize ? maximize_width : 0)
                            - minimize_width - 3, rect.top() - titleHeight,
                            minimize_width, titleHeight);
                    if (r.left() > rect.left() + titleHeight)
                        region = r;
                }
            }
            break;

        case Maximize: {
                if (hasMaximize && !isMaximized) {
                    QRect r(rect.right() - close_width - maximize_width - 3,
                            rect.top() - titleHeight, maximize_width, titleHeight);
                    if (r.left() > rect.left() + titleHeight)
                        region = r;
                }
            }
            break;

        case Normalize: {
                if (hasMinimize && isMinimized) {
                    QRect r(rect.right() - close_width
                            - (hasMaximize ? maximize_width : 0)
                            - minimize_width - 3, rect.top() - titleHeight,
                            minimize_width, titleHeight);
                    if (r.left() > rect.left() + titleHeight)
                        region = r;
                } else if (hasMaximize && isMaximized) {
                    QRect r(rect.right() - close_width - maximize_width - 3,
                            rect.top() - titleHeight, maximize_width, titleHeight);
                    if (r.left() > rect.left() + titleHeight)
                        region = r;
                }
            }
            break;

        case Close: {
                QRect r(rect.right() - close_width - 1, rect.top() - titleHeight,
                        close_width, titleHeight);
                if (r.left() > rect.left() + titleHeight)
                    region = r;
            }
            break;

        default:
            region = QDecorationDefault::region(widget, rect, type);
            break;
    }

    return region;
}

xpmForRegion()

const char ** QDecorationWindows::xpmForRegion ( int  region )

protectedvirtual

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

Reimplemented from QDecorationDefault.

Definition at line 186 of file qdecorationwindows_qws.cpp.

{
#ifdef QT_NO_IMAGEFORMAT_XPM
    Q_UNUSED(reg);
#else
    switch(reg)
    {
    case Close:
        return (const char **)win_close_xpm;
    case Help:
        return (const char **)win_help_xpm;
    case Minimize:
        return (const char **)win_minimize_xpm;
    case Maximize:
        return (const char **)win_maximize_xpm;
    case Normalize:
        return (const char **)win_normalize_xpm;
    default:
        return QDecorationDefault::xpmForRegion(reg);
    }
#endif
    return 0;
}

---

The documentation for this class was generated from the following files:

• /src/gui/embedded/qdecorationwindows_qws.h
• /src/gui/embedded/qdecorationwindows_qws.cpp