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
|
/***************************************************************************
* 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;
/**
* @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);
/** @see SidebarPage::setSelection() */
virtual void setSelection(const QList<KFileItem>& 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);
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();
/**
* Adds the texts \a labelText and \a infoText as one formated line
* to text.
*/
void addInfoLine(QString& text,
const QString& labelText,
const QString& infoText);
/**
* 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;
private:
bool m_pendingPreview;
QTimer* m_timer;
KUrl m_shownUrl;
KUrl m_urlCandidate;
PixmapViewer* m_preview;
QLabel* m_nameLabel;
QLabel* m_infoLabel;
MetaDataWidget* m_metadataWidget;
};
#endif // INFOSIDEBARPAGE_H
|
