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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
/*****************************************************************************
* Copyright (C) 2006 by Peter Penz <peter.penz@gmx.at> *
* Copyright (C) 2006 by Aaron J. Seigo <aseigo@kde.org> *
* *
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Library General Public *
* License as published by the Free Software Foundation; either *
* version 2 of the License, or (at your option) any later version. *
* *
* 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 KURLNAVIGATORBUTTON_P_H
#define KURLNAVIGATORBUTTON_P_H
#include "kurlnavigatorbuttonbase_p.h"
#include "kurlnavigatormenu_p.h"
#include <kio/global.h>
#include <kio/udsentry.h>
#include <kurl.h>
#include <QPointer>
class KJob;
class QDropEvent;
class QPaintEvent;
namespace KIO
{
class Job;
}
namespace KDEPrivate
{
/**
* @brief Button of the URL navigator which contains one part of an URL.
*
* It is possible to drop a various number of items to an UrlNavigatorButton. In this case
* a context menu is opened where the user must select whether he wants
* to copy, move or link the dropped items to the URL part indicated by
* the button.
*/
class KUrlNavigatorButton : public KUrlNavigatorButtonBase
{
Q_OBJECT
public:
explicit KUrlNavigatorButton(const KUrl& url, QWidget* parent);
virtual ~KUrlNavigatorButton();
void setUrl(const KUrl& url);
KUrl url() const;
/* Implementation note: QAbstractButton::setText() is not virtual,
* but KUrlNavigatorButton needs to adjust the minimum size when
* the text has been changed. KUrlNavigatorButton::setText() hides
* QAbstractButton::setText() which is not nice, but sufficient for
* the usage in KUrlNavigator.
*/
void setText(const QString& text);
/**
* Sets the name of the sub directory that should be marked when
* opening the sub directories popup.
*/
void setActiveSubDirectory(const QString& subDir);
QString activeSubDirectory() const;
/** @see QWidget::sizeHint() */
virtual QSize sizeHint() const;
void setShowMnemonic(bool show);
bool showMnemonic() const;
Q_SIGNALS:
/**
* Is emitted if URLs have been dropped
* to the destination \a destination.
*/
void urlsDropped(const KUrl& destination, QDropEvent* event);
void clicked(const KUrl& url, Qt::MouseButton button);
/**
* Is emitted, if KUrlNavigatorButton::setUrl() cannot resolve
* the text synchronously and KUrlNavigator::text() will return
* an empty string in this case. The signal finishedTextResolving() is
* emitted, as soon as the text has been resolved.
*/
void startedTextResolving();
/**
* Is emitted, if the asynchronous resolving of the text has
* been finished (see startTextResolving()).
* KUrlNavigatorButton::text() contains the resolved text.
*/
void finishedTextResolving();
protected:
virtual void paintEvent(QPaintEvent* event);
virtual void enterEvent(QEvent* event);
virtual void leaveEvent(QEvent* event);
virtual void keyPressEvent(QKeyEvent* event);
virtual void dropEvent(QDropEvent* event);
virtual void dragEnterEvent(QDragEnterEvent* event);
virtual void dragMoveEvent(QDragMoveEvent* event);
virtual void dragLeaveEvent(QDragLeaveEvent* event);
virtual void mousePressEvent(QMouseEvent* event);
virtual void mouseReleaseEvent(QMouseEvent* event);
virtual void mouseMoveEvent(QMouseEvent* event);
virtual void wheelEvent(QWheelEvent* event);
private Q_SLOTS:
/**
* Requests to load the sub-directories after a short delay.
* startSubDirsJob() is invoked if the delay is exceeded.
*/
void requestSubDirs();
/**
* Starts to load the sub directories asynchronously. The directories
* are stored in m_subDirs by addEntriesToSubDirs().
*/
void startSubDirsJob();
/**
* Adds the entries from the sub-directories job to m_subDirs. The entries
* will be shown if the job has been finished in openSubDirsMenu() or
* replaceButton().
*/
void addEntriesToSubDirs(KIO::Job* job, const KIO::UDSEntryList& entries);
/**
* Is called after the sub-directories job has been finished and opens a menu
* showing all sub directories.
*/
void openSubDirsMenu(KJob* job);
/**
* Is called after the sub-directories job has been finished and replaces
* the button content by the current sub directory (triggered by
* the scroll wheel).
*/
void replaceButton(KJob* job);
void urlsDropped(QAction* action, QDropEvent* event);
/**
* Is called, if an action of a sub-menu has been triggered by
* a click with the middle mouse-button.
*/
void slotMenuActionClicked(QAction* action);
void statFinished(KJob*);
private:
/**
* Cancels any request done by requestSubDirs().
*/
void cancelSubDirsRequest();
/**
* @return Text without mnemonic characters.
*/
QString plainText() const;
int arrowWidth() const;
bool isAboveArrow(int x) const;
bool isTextClipped() const;
void updateMinimumWidth();
void initMenu(KUrlNavigatorMenu* menu, int startIndex);
private:
bool m_hoverArrow;
bool m_pendingTextChange;
bool m_replaceButton;
bool m_showMnemonic;
int m_wheelSteps;
KUrl m_url;
QString m_subDir;
QTimer* m_openSubDirsTimer;
KIO::Job* m_subDirsJob;
/// pair of name and display name
QList<QPair<QString,QString> > m_subDirs;
static QPointer<KUrlNavigatorMenu> m_subDirsMenu;
};
} // namespace KDEPrivate
#endif
|
