Widget.h

Go to the documentation of this file.

/*
 *   Copyright (C) 2007, 2008, 2009, 2010 Ivan Cukic <ivan.cukic(at)kde.org>
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU Lesser/Library General Public License version 2,
 *   or (at your option) any later version, as published by the Free
 *   Software Foundation
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU Lesser/Library General Public License for more details
 *
 *   You should have received a copy of the GNU Lesser/Library General Public
 *   License along with this program; if not, write to the
 *   Free Software Foundation, Inc.,
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

#ifndef LANCELOT_WIDGET_H
#define LANCELOT_WIDGET_H

#include <QtGui/QGraphicsWidget>

#include <lancelot/lancelot_export.h>
#include <lancelot/lancelot.h>
#include <lancelot/Global.h>

namespace Lancelot
{

class LANCELOT_EXPORT Widget : public QGraphicsWidget {
    Q_OBJECT

    Q_PROPERTY(QString group READ groupName WRITE setGroupByName)
    Q_PROPERTY(bool down READ isDown WRITE setDown)

    // @puck L_WIDGET
    // @puck L_INCLUDE(lancelot/widgets/Widget.h QString)

public:
    Widget(QGraphicsItem * parent = 0);

    virtual ~Widget();

    virtual void setGroupByName(const QString & groupName);

    QString groupName() const;

    virtual void setGroup(Group * group = NULL);

    Group * group() const;

    bool isHovered() const;

    bool isDown() const;

protected:
    L_Override QSizeF sizeHint(Qt::SizeHint which,
            const QSizeF & constraint = QSizeF()) const;

    void setPaintBackwardsWhenRTL(bool value);

Q_SIGNALS:
    void mouseHoverEnter();

    void mouseHoverLeave();

    void clicked();

    void pressed();

    void released();

protected:
    void paintBackground(QPainter * painter);

    void paintBackground(QPainter * painter, const QString & element);

    void setHovered(bool value);

    void setDown(bool value);

    L_Override void hoverEnterEvent(QGraphicsSceneHoverEvent * event);
    L_Override void hoverLeaveEvent(QGraphicsSceneHoverEvent * event);

    L_Override void mousePressEvent(QGraphicsSceneMouseEvent * event);
    L_Override void mouseReleaseEvent(QGraphicsSceneMouseEvent * event);
    L_Override void hideEvent(QHideEvent * event);

    L_Override void paint(QPainter * painter,
            const QStyleOptionGraphicsItem * option, QWidget * widget = 0);

private:
    class Private;
    Private * const d;
};

} // namespace Lancelot

#endif /* LANCELOT_WIDGET_H */