• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdepimlibs-4.14.10 API Reference
  • KDE Home
  • Contact Us
 

akonadi

  • akonadi
collectionview.cpp
1 /*
2  Copyright (c) 2006 - 2007 Volker Krause <vkrause@kde.org>
3 
4  This library is free software; you can redistribute it and/or modify it
5  under the terms of the GNU Library General Public License as published by
6  the Free Software Foundation; either version 2 of the License, or (at your
7  option) any later version.
8 
9  This library is distributed in the hope that it will be useful, but WITHOUT
10  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
12  License for more details.
13 
14  You should have received a copy of the GNU Library General Public License
15  along with this library; see the file COPYING.LIB. If not, write to the
16  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  02110-1301, USA.
18 */
19 
20 #include "collectionview.h"
21 
22 #include "collection.h"
23 #include "collectionmodel.h"
24 #include "control.h"
25 
26 #include <kicon.h>
27 #include <kaction.h>
28 #include <kdebug.h>
29 #include <klocalizedstring.h>
30 #include <kmessagebox.h>
31 #include <kurl.h>
32 #include <kxmlguifactory.h>
33 #include <kxmlguiwindow.h>
34 
35 #include <QtCore/QDebug>
36 #include <QtCore/QTimer>
37 #include <QApplication>
38 #include <QDragMoveEvent>
39 #include <QHeaderView>
40 #include <QMenu>
41 
42 using namespace Akonadi;
43 
47 class CollectionView::Private
48 {
49 public:
50  Private(CollectionView *parent)
51  : mParent(parent)
52  , xmlGuiClient(0)
53  {
54  }
55 
56  void init();
57  void dragExpand();
58  void itemClicked(const QModelIndex &);
59  void itemCurrentChanged(const QModelIndex &);
60  bool hasParent(const QModelIndex &idx, Collection::Id parentId);
61 
62  CollectionView *mParent;
63  QModelIndex dragOverIndex;
64  QTimer dragExpandTimer;
65 
66  KXMLGUIClient *xmlGuiClient;
67 };
68 
69 void CollectionView::Private::init()
70 {
71  mParent->header()->setClickable(true);
72  mParent->header()->setStretchLastSection(false);
73 
74  mParent->setSortingEnabled(true);
75  mParent->sortByColumn(0, Qt::AscendingOrder);
76  mParent->setEditTriggers(QAbstractItemView::EditKeyPressed);
77  mParent->setAcceptDrops(true);
78  mParent->setDropIndicatorShown(true);
79  mParent->setDragDropMode(DragDrop);
80  mParent->setDragEnabled(true);
81 
82  dragExpandTimer.setSingleShot(true);
83  mParent->connect(&dragExpandTimer, SIGNAL(timeout()), SLOT(dragExpand()));
84 
85  mParent->connect(mParent, SIGNAL(clicked(QModelIndex)),
86  mParent, SLOT(itemClicked(QModelIndex)));
87 
88  Control::widgetNeedsAkonadi(mParent);
89 }
90 
91 bool CollectionView::Private::hasParent(const QModelIndex &idx, Collection::Id parentId)
92 {
93  QModelIndex idx2 = idx;
94  while (idx2.isValid()) {
95  if (mParent->model()->data(idx2, CollectionModel::CollectionIdRole).toLongLong() == parentId) {
96  return true;
97  }
98 
99  idx2 = idx2.parent();
100  }
101  return false;
102 }
103 
104 void CollectionView::Private::dragExpand()
105 {
106  mParent->setExpanded(dragOverIndex, true);
107  dragOverIndex = QModelIndex();
108 }
109 
110 void CollectionView::Private::itemClicked(const QModelIndex &index)
111 {
112  if (!index.isValid()) {
113  return;
114  }
115 
116  const Collection collection = index.model()->data(index, CollectionModel::CollectionRole).value<Collection>();
117  if (!collection.isValid()) {
118  return;
119  }
120 
121  emit mParent->clicked(collection);
122 }
123 
124 void CollectionView::Private::itemCurrentChanged(const QModelIndex &index)
125 {
126  if (!index.isValid()) {
127  return;
128  }
129 
130  const Collection collection = index.model()->data(index, CollectionModel::CollectionRole).value<Collection>();
131  if (!collection.isValid()) {
132  return;
133  }
134 
135  emit mParent->currentChanged(collection);
136 }
137 
138 CollectionView::CollectionView(QWidget *parent)
139  : QTreeView(parent)
140  , d(new Private(this))
141 {
142  d->init();
143 }
144 
145 CollectionView::CollectionView(KXMLGUIClient *xmlGuiClient, QWidget *parent)
146  : QTreeView(parent)
147  , d(new Private(this))
148 {
149  d->xmlGuiClient = xmlGuiClient;
150  d->init();
151 }
152 
153 CollectionView::CollectionView(KXmlGuiWindow *xmlGuiWindow, QWidget *parent)
154  : QTreeView(parent)
155  , d(new Private(this))
156 {
157  d->xmlGuiClient = static_cast<KXMLGUIClient *>(xmlGuiWindow);
158  d->init();
159 }
160 
161 CollectionView::~CollectionView()
162 {
163  delete d;
164 }
165 
166 void CollectionView::setModel(QAbstractItemModel *model)
167 {
168  QTreeView::setModel(model);
169  header()->setStretchLastSection(true);
170 
171  connect(selectionModel(), SIGNAL(currentChanged(QModelIndex,QModelIndex)),
172  this, SLOT(itemCurrentChanged(QModelIndex)));
173 }
174 
175 void CollectionView::dragMoveEvent(QDragMoveEvent *event)
176 {
177  QModelIndex index = indexAt(event->pos());
178  if (d->dragOverIndex != index) {
179  d->dragExpandTimer.stop();
180  if (index.isValid() && !isExpanded(index) && itemsExpandable()) {
181  d->dragExpandTimer.start(QApplication::startDragTime());
182  d->dragOverIndex = index;
183  }
184  }
185 
186  // Check if the collection under the cursor accepts this data type
187  const QStringList supportedContentTypes = model()->data(index, CollectionModel::CollectionRole).value<Collection>().contentMimeTypes();
188  const QMimeData *mimeData = event->mimeData();
189  const KUrl::List urls = KUrl::List::fromMimeData(mimeData);
190  foreach (const KUrl &url, urls) {
191 
192  const Collection collection = Collection::fromUrl(url);
193  if (collection.isValid()) {
194  if (!supportedContentTypes.contains(QString::fromLatin1("inode/directory"))) {
195  break;
196  }
197 
198  // Check if we don't try to drop on one of the children
199  if (d->hasParent(index, collection.id())) {
200  break;
201  }
202  } else {
203  const QString type = url.queryItems()[QString::fromLatin1("type")];
204  if (!supportedContentTypes.contains(type)) {
205  break;
206  }
207  }
208 
209  QTreeView::dragMoveEvent(event);
210  return;
211  }
212 
213  event->setDropAction(Qt::IgnoreAction);
214 }
215 
216 void CollectionView::dragLeaveEvent(QDragLeaveEvent *event)
217 {
218  d->dragExpandTimer.stop();
219  d->dragOverIndex = QModelIndex();
220  QTreeView::dragLeaveEvent(event);
221 }
222 
223 void CollectionView::dropEvent(QDropEvent *event)
224 {
225  d->dragExpandTimer.stop();
226  d->dragOverIndex = QModelIndex();
227 
228  // open a context menu offering different drop actions (move, copy and cancel)
229  // TODO If possible, hide non available actions ...
230  QMenu popup(this);
231  QAction *moveDropAction = popup.addAction(KIcon(QString::fromLatin1("edit-rename")), i18n("&Move here"));
232  QAction *copyDropAction = popup.addAction(KIcon(QString::fromLatin1("edit-copy")), i18n("&Copy here"));
233  popup.addSeparator();
234  popup.addAction(KIcon(QString::fromLatin1("process-stop")), i18n("Cancel"));
235 
236  QAction *activatedAction = popup.exec(QCursor::pos());
237  if (activatedAction == moveDropAction) {
238  event->setDropAction(Qt::MoveAction);
239  } else if (activatedAction == copyDropAction) {
240  event->setDropAction(Qt::CopyAction);
241  } else {
242  return;
243  }
244 
245  QTreeView::dropEvent(event);
246 }
247 
248 void CollectionView::contextMenuEvent(QContextMenuEvent *event)
249 {
250  if (!d->xmlGuiClient) {
251  return;
252  }
253  QMenu *popup = static_cast<QMenu *>(d->xmlGuiClient->factory()->container(
254  QLatin1String("akonadi_collectionview_contextmenu"), d->xmlGuiClient));
255  if (popup) {
256  popup->exec(event->globalPos());
257  }
258 }
259 
260 void CollectionView::setXmlGuiClient(KXMLGUIClient *xmlGuiClient)
261 {
262  d->xmlGuiClient = xmlGuiClient;
263 }
264 
265 void CollectionView::setXmlGuiWindow(KXmlGuiWindow *xmlGuiWindow)
266 {
267  d->xmlGuiClient = static_cast<KXMLGUIClient *>(xmlGuiWindow);
268 }
269 
270 #include "moc_collectionview.cpp"
Akonadi::Collection
Represents a collection of PIM items.
Definition: collection.h:75
Akonadi::CollectionView
A view to show a collection tree provided by a CollectionModel.
Definition: collectionview.h:63
Akonadi::Entity::Id
qint64 Id
Describes the unique id type.
Definition: entity.h:65
Akonadi::CollectionView::setXmlGuiClient
void setXmlGuiClient(KXMLGUIClient *xmlGuiClient)
Sets the KXMLGUIClient which the view is used in.
Definition: collectionview.cpp:260
Akonadi::CollectionView::setXmlGuiWindow
AKONADI_DEPRECATED void setXmlGuiWindow(KXmlGuiWindow *xmlGuiWindow)
Sets the KXmlGuiWindow which the view is used in.
Definition: collectionview.cpp:265
Akonadi::CollectionView::currentChanged
void currentChanged(const Akonadi::Collection &collection)
This signal is emitted whenever the current collection in the view has changed.
Akonadi::Control::widgetNeedsAkonadi
static void widgetNeedsAkonadi(QWidget *widget)
Disable the given widget when Akonadi is not operational and show an error overlay (given enough spac...
Definition: control.cpp:264
Akonadi::Entity::id
Id id() const
Returns the unique identifier of the entity.
Definition: entity.cpp:72
Akonadi::CollectionModel::CollectionRole
The actual collection object.
Definition: collectionmodel.h:66
Akonadi
FreeBusyManager::Singleton.
Definition: actionstatemanager_p.h:28
Akonadi::Entity::isValid
bool isValid() const
Returns whether the entity is valid.
Definition: entity.cpp:97
Akonadi::CollectionModel::CollectionIdRole
The collection identifier.
Definition: collectionmodel.h:65
Akonadi::Collection::fromUrl
static Collection fromUrl(const KUrl &url)
Creates a collection from the given url.
Definition: collection.cpp:172
Akonadi::CollectionView::~CollectionView
virtual ~CollectionView()
Destroys the collection view.
Definition: collectionview.cpp:161
Akonadi::CollectionView::CollectionView
CollectionView(QWidget *parent=0)
Creates a new collection view.
Definition: collectionview.cpp:138
This file is part of the KDE documentation.
Documentation copyright © 1996-2015 The KDE developers.
Generated on Wed Jul 29 2015 19:20:58 by doxygen 1.8.9.1 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

akonadi

Skip menu "akonadi"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • Modules
  • Related Pages

kdepimlibs-4.14.10 API Reference

Skip menu "kdepimlibs-4.14.10 API Reference"
  • akonadi
  •   contact
  •   kmime
  •   socialutils
  • kabc
  • kalarmcal
  • kblog
  • kcal
  • kcalcore
  • kcalutils
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmbox
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal