← Back to branch summary

~ubuntu-branches/debian/sid/kde-baseapps/sid

« back to all changes in this revision

Viewing changes to dolphin/src/kitemviews/kitemlistgroupheader.h

  • Committer: Package Import Robot
  • Author(s): Modestas Vainius, Eshat Cakar, Pino Toscano
  • Date: 2012-06-09 22:18:08 UTC
  • mfrom: (4.2.1) (6.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20120609221808-h1l0ekd5qmb8nefr
Tags: 4:4.8.4-1
* New upstream release.

[ Eshat Cakar ]
* Add watch file.
* Bump kde-sc-dev-latest build dependency to version 4:4.8.4.
* Update installed files.

[ Pino Toscano ]
* Move files of the konqueror documentation from kde-baseapps-data to
  konqueror itself.

Show diffs side-by-side

added added

removed removed

Lines of Context:
dolphin/src/kitemviews/kitemlistgroupheader.h
 
1
/***************************************************************************
 
2
 *   Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com>             *
 
3
 *                                                                         *
 
4
 *   This program is free software; you can redistribute it and/or modify  *
 
5
 *   it under the terms of the GNU General Public License as published by  *
 
6
 *   the Free Software Foundation; either version 2 of the License, or     *
 
7
 *   (at your option) any later version.                                   *
 
8
 *                                                                         *
 
9
 *   This program is distributed in the hope that it will be useful,       *
 
10
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 
11
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 
12
 *   GNU General Public License for more details.                          *
 
13
 *                                                                         *
 
14
 *   You should have received a copy of the GNU General Public License     *
 
15
 *   along with this program; if not, write to the                         *
 
16
 *   Free Software Foundation, Inc.,                                       *
 
17
 *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
 
18
 ***************************************************************************/
 
19
 
 
20
#ifndef KITEMLISTGROUPHEADER_H
 
21
#define KITEMLISTGROUPHEADER_H
 
22
 
 
23
#include <libdolphin_export.h>
 
24
 
 
25
#include <kitemviews/kitemliststyleoption.h>
 
26
 
 
27
#include <QByteArray>
 
28
#include <QGraphicsWidget>
 
29
#include <QVariant>
 
30
 
 
31
class KItemListView;
 
32
 
 
33
/**
 
34
 * @brief Base class for group headers.
 
35
 *
 
36
 * Draws a default header background. Derived classes must reimplement
 
37
 * the method paint() and draw the role within the given roleBounds() with
 
38
 * the color roleColor().
 
39
 */
 
40
class LIBDOLPHINPRIVATE_EXPORT KItemListGroupHeader : public QGraphicsWidget
 
41
{
 
42
    Q_OBJECT
 
43
 
 
44
public:
 
45
    KItemListGroupHeader(QGraphicsWidget* parent = 0);
 
46
    virtual ~KItemListGroupHeader();
 
47
 
 
48
    void setRole(const QByteArray& role);
 
49
    QByteArray role() const;
 
50
 
 
51
    void setData(const QVariant& data);
 
52
    QVariant data() const;
 
53
 
 
54
    void setStyleOption(const KItemListStyleOption& option);
 
55
    const KItemListStyleOption& styleOption() const;
 
56
 
 
57
    /**
 
58
     * Sets the scroll orientation that is used by the KItemListView.
 
59
     * This allows the group header to use a modified look dependent
 
60
     * on the orientation.
 
61
     */
 
62
    void setScrollOrientation(Qt::Orientation orientation);
 
63
    Qt::Orientation scrollOrientation() const;
 
64
 
 
65
    void setItemIndex(int index);
 
66
    int itemIndex() const;
 
67
 
 
68
    virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0);
 
69
 
 
70
protected:
 
71
    /** @return Bounding rectangle where the role should be drawn into. */
 
72
    QRectF roleBounds() const;
 
73
 
 
74
    /** @return Primary color that should be used for drawing the role. */
 
75
    QColor roleColor() const;
 
76
 
 
77
    /**
 
78
     * Is called after the role has been changed and allows the derived class
 
79
     * to react on this change.
 
80
     */
 
81
    virtual void roleChanged(const QByteArray& current, const QByteArray& previous);
 
82
 
 
83
    /**
 
84
     * Is called after the role has been changed and allows the derived class
 
85
     * to react on this change.
 
86
     */
 
87
    virtual void dataChanged(const QVariant& current, const QVariant& previous);
 
88
 
 
89
    /**
 
90
     * Is called after the style option has been changed and allows the derived class
 
91
     * to react on this change.
 
92
     */
 
93
    virtual void styleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
 
94
 
 
95
    /**
 
96
     * Is called after the scroll orientation has been changed and allows the derived class
 
97
     * to react on this change.
 
98
     */
 
99
    virtual void scrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous);
 
100
 
 
101
    /**
 
102
     * Is called after the item index has been changed and allows the derived class to react on
 
103
     * this change.
 
104
     */
 
105
    virtual void itemIndexChanged(int current, int previous);
 
106
 
 
107
    /** @reimp */
 
108
    virtual void resizeEvent(QGraphicsSceneResizeEvent* event);
 
109
 
 
110
private:
 
111
    void updateCache();
 
112
 
 
113
    static QColor mixedColor(const QColor& c1, const QColor& c2, int c1Percent = 50);
 
114
 
 
115
private:
 
116
    bool m_dirtyCache;
 
117
    QByteArray m_role;
 
118
    QVariant m_data;
 
119
    KItemListStyleOption m_styleOption;
 
120
    Qt::Orientation m_scrollOrientation;
 
121
    int m_itemIndex;
 
122
 
 
123
    QColor m_lineColor;
 
124
    QColor m_roleColor;
 
125
    QRectF m_roleBounds;
 
126
};
 
127
#endif
 
128
 
 
129