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
|
/***************************************************************************
* Copyright (C) 2006 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 INFOSIDEBARPAGE_H
#define INFOSIDEBARPAGE_H
#include <sidebarpage.h>
#include <QtGui/QPushButton>
#include <QtGui/QPixmap>
#include <QtCore/QEvent>
#include <QtGui/QLabel>
#include <QtCore/QList>
#include <kurl.h>
#include <kmimetype.h>
#include <kdesktopfileactions.h>
#include <kvbox.h>
class QPixmap;
class QString;
class KFileItem;
class QLabel;
class PixmapViewer;
class MetaDataWidget;
class MetaTextLabel;
/**
* @brief Sidebar for showing meta information of one ore more selected items.
*/
class InfoSidebarPage : public SidebarPage
{
Q_OBJECT
public:
explicit InfoSidebarPage(QWidget* parent = 0);
virtual ~InfoSidebarPage();
/** @see QWidget::sizeHint() */
virtual QSize sizeHint() const;
public slots:
/** @see SidebarPage::setUrl() */
virtual void setUrl(const KUrl& url);
/**
* This is invoked to inform the sidebar that the user has selected a new
* set of items.
*/
void setSelection(const KFileItemList& selection);
/**
* Does a delayed request of information for the item \a item.
* If within this delay InfoSidebarPage::setUrl() or InfoSidebarPage::setSelection()
* are invoked, then the request will be skipped. Requesting a delayed item information
* makes sense when hovering items.
*/
void requestDelayedItemInfo(const KFileItem& item);
protected:
/** @see QWidget::showEvent() */
virtual void showEvent(QShowEvent* event);
/** @see QWidget::resizeEvent() */
virtual void resizeEvent(QResizeEvent* event);
private slots:
/**
* Shows the information for the item of the URL which has been provided by
* InfoSidebarPage::requestItemInfo() and provides default actions.
*/
void showItemInfo();
/**
* Triggered if the request for item information has timed out.
* @see InfoSidebarPage::requestDelayedItemInfo()
*/
void slotTimeout();
/**
* Is invoked if no preview is available for the item. In this
* case the icon will be shown.
*/
void showIcon(const KFileItem& item);
/**
* Is invoked if a preview is available for the item. The preview
* \a pixmap is shown inside the info page.
*/
void showPreview(const KFileItem& item, const QPixmap& pixmap);
void slotFileRenamed(const QString& source, const QString& dest);
void slotFilesAdded(const QString& directory);
void slotFilesChanged(const QStringList& files);
void slotFilesRemoved(const QStringList& files);
void slotEnteredDirectory(const QString& directory);
void slotLeftDirectory(const QString& directory);
private:
enum { TimerDelay = 300 };
/**
* Checks whether the an URL is repesented by a place. If yes,
* then the place icon and name are shown instead of a preview.
* @return True, if the URL represents exactly a place.
* @param url The url to check.
*/
bool applyPlace(const KUrl& url);
/** Assures that any pending item information request is cancelled. */
void cancelRequest();
/**
* Shows the meta information for the current shown item inside
* a label.
*/
void showMetaInfo();
/**
* Converts the meta key \a key to a readable format into \a text.
* Returns true, if the string \a key represents a meta information
* that should be shown. If false is returned, \a text is not modified.
*/
bool convertMetaInfo(const QString& key, QString& text) const;
/**
* Returns the URL of the file where the preview and meta information
* should be received, if InfoSidebarPage::showMultipleSelectionInfo()
* returns false.
*/
KUrl fileUrl() const;
/**
* Returns true, if the meta information should be shown for
* the multiple selected items that are stored in
* m_selection. If true is returned, it is assured that
* m_selection.count() > 1. If false is returned, the meta
* information should be shown for the file
* InfosidebarPage::fileUrl();
*/
bool showMultipleSelectionInfo() const;
void init();
private:
bool m_initialized;
bool m_pendingPreview;
QTimer* m_timer;
KUrl m_shownUrl; // URL that is shown as info
KUrl m_urlCandidate; // URL candidate that will replace m_shownURL after a delay
KFileItem m_fileItem; // file item for m_shownUrl if available (otherwise null)
KFileItemList m_selection;
QLabel* m_nameLabel;
PixmapViewer* m_preview;
MetaDataWidget* m_metaDataWidget;
MetaTextLabel* m_metaTextLabel;
};
#endif // INFOSIDEBARPAGE_H
|
