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