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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
/*
This file is part of the Nepomuk KDE project.
Copyright (C) 2007 Sebastian Trueg <[email protected]>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License version 2 as published by the Free Software Foundation.
This library 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef _NEPOMUK_TAG_CLOUD_H_
#define _NEPOMUK_TAG_CLOUD_H_
#include <QtGui/QFrame>
#include <QtCore/QList>
#include <nepomuk/tag.h>
#include <nepomuk/nepomuk_export.h>
#include <Soprano/Statement>
class QResizeEvent;
class QPaintEvent;
class QMouseEvent;
class QEvent;
namespace Nepomuk {
class NEPOMUK_EXPORT TagCloud : public QFrame
{
Q_OBJECT
public:
TagCloud( QWidget* parent = 0 );
~TagCloud();
enum Sorting {
SortAlpabetically,
SortByWeight,
SortRandom
};
int heightForWidth( int w ) const;
QSize sizeHint() const;
QSize minimumSizeHint() const;
bool zoomEnabled() const;
public Q_SLOTS:
/**
* Set the maximum used font size. The default is 0
* which means to calculate proper values from the KDE
* defaults.
*/
void setMaxFontSize( int size );
/**
* Set the minimum used font size. The default is 0
* which means to calculate proper values from the KDE
* defaults.
*/
void setMinFontSize( int size );
/**
* Set the maximum number of displayed tags. The default is 0
* which means to display all tags.
*
* NOT IMPLEMENTED YET
*/
void setMaxNumberDisplayedTags( int n );
/**
* Allow selection of tags, i.e. enabling and disabling of tags.
*/
void setSelectionEnabled( bool enabled );
void setNewTagButtonEnabled( bool enabled );
void setContextMenuEnabled( bool enabled );
void setAlignment( Qt::Alignment alignment );
void setZoomEnabled( bool zoom );
/**
* Default: SortAlpabetically
*/
void setSorting( Sorting );
/**
* Will reset tags set via showTags()
*/
void showAllTags();
/**
* Set the tags to be shown in the tag cloud.
* If the new tag button is enabled (setEnableNewTagButton())
* new tags will automatically be added to the list of shown tags.
*/
void showTags( const QList<Tag>& tags );
void showResourceTags( const Resource& resource );
/**
* Select or deselect a tag. This does only make sense
* if selection is enabled and \p tag is actually
* displayed.
*
* \sa setSelectionEnabled
*/
void setTagSelected( const Tag& tag, bool selected );
void setCustomNewTagAction( QAction* action );
Q_SIGNALS:
void tagClicked( const Nepomuk::Tag& tag );
void tagAdded( const Nepomuk::Tag& tag );
void tagToggled( const Nepomuk::Tag& tag, bool enabled );
protected:
void resizeEvent( QResizeEvent* e );
void paintEvent( QPaintEvent* e );
void mousePressEvent( QMouseEvent* );
void mouseMoveEvent( QMouseEvent* );
void leaveEvent( QEvent* );
private Q_SLOTS:
void slotStatementAdded( const Soprano::Statement& s );
void slotStatementRemoved( const Soprano::Statement& s );
private:
class Private;
Private* const d;
};
}
#endif
|
