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
|
/***************************************************************************
* Copyright (C) 2007 by Peter Penz <[email protected]> *
* Copyright (C) 2007 by David Faure <[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 DRAGANDDROPHELPER_H
#define DRAGANDDROPHELPER_H
#include "libdolphin_export.h"
#include <QObject>
class DolphinController;
class KFileItem;
class KUrl;
class QDropEvent;
class QMimeData;
class QAbstractItemView;
class QBrush;
class QRect;
class QWidget;
/**
* @brief Helper class for having a common drag and drop behavior.
*
* The class is used by DolphinIconsView, DolphinDetailsView,
* DolphinColumnView and PanelTreeView to have a consistent
* drag and drop behavior between all views.
*/
class LIBDOLPHINPRIVATE_EXPORT DragAndDropHelper : public QObject
{
Q_OBJECT
public:
static DragAndDropHelper& instance();
/**
* Returns true, if Dolphin supports the dragging of
* the given mime data.
*/
bool isMimeDataSupported(const QMimeData* mimeData) const;
/**
* Creates a drag object for the view \a itemView for all selected items.
*/
void startDrag(QAbstractItemView* itemView,
Qt::DropActions supportedActions,
DolphinController* controller = 0);
/**
* Returns true if and only if the view \a itemView was the last view to
* be passed to startDrag(...), and that drag is still in progress.
*/
bool isDragSource(QAbstractItemView* itemView);
/**
* Handles the dropping of URLs to the given
* destination. A context menu with the options
* 'Move Here', 'Copy Here', 'Link Here' and
* 'Cancel' is offered to the user.
* @param destItem Item of the destination (can be null, see KFileItem::isNull()).
* @param destPath Path of the destination.
* @param event Drop event.
* @param widget Source widget where the dragging has been started.
*/
void dropUrls(const KFileItem& destItem,
const KUrl& destPath,
QDropEvent* event,
QWidget* widget);
signals:
void errorMessage(const QString& msg);
private:
DragAndDropHelper();
// The last view passed in startDrag(...), or 0 if
// no startDrag(...) initiated drag is in progress.
QAbstractItemView *m_dragSource;
friend class DragAndDropHelperSingleton;
};
#endif
|
