blob: f4765955b2e19362fe1c02c601f624de6cf2345a (
plain)
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
|
/***************************************************************************
* Copyright (C) 2010 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 VIEWMODECONTROLLER_H
#define VIEWMODECONTROLLER_H
#include <KUrl>
#include <QObject>
#include <libdolphin_export.h>
#include <views/dolphinview.h>
/**
* @brief Allows the DolphinView to control the view implementations for the
* different view modes.
*
* The view implementations (DolphinIconsView, DolphinDetailsView, DolphinColumnView)
* connect to signals of the ViewModeController to react on changes. The view
* implementations get only read-access to the ViewModeController.
*/
class LIBDOLPHINPRIVATE_EXPORT ViewModeController : public QObject
{
Q_OBJECT
public:
explicit ViewModeController(QObject* parent = 0);
virtual ~ViewModeController();
/**
* @return URL that is shown by the view mode implementation.
*/
KUrl url() const;
/**
* Sets the URL to \a url and does nothing else. Called when
* a redirection happens. See ViewModeController::setUrl()
*/
void redirectToUrl(const KUrl& url);
/**
* Informs the view mode implementation about a change of the activation
* state by emitting the signal activationChanged().
*/
void indicateActivationChange(bool active);
/**
* Sets the zoom level to \a level and emits the signal zoomLevelChanged().
* It must be assured that the used level is inside the range
* ViewModeController::zoomLevelMinimum() and
* ViewModeController::zoomLevelMaximum().
*/
void setZoomLevel(int level);
int zoomLevel() const;
/**
* Sets the name filter to \a and emits the signal nameFilterChanged().
*/
void setNameFilter(const QString& nameFilter);
QString nameFilter() const;
/**
* Requests the view mode implementation to hide tooltips.
*/
void requestToolTipHiding();
public slots:
/**
* Sets the URL to \a url and emits the signals cancelPreviews() and
* urlChanged() if \a url is different for the current URL.
*/
void setUrl(const KUrl& url);
signals:
/**
* Is emitted if the URL has been changed by ViewModeController::setUrl().
*/
void urlChanged(const KUrl& url);
/**
* Is emitted, if ViewModeController::indicateActivationChange() has been
* invoked. The view mode implementation may update its visual state
* to represent the activation state.
*/
void activationChanged(bool active);
/**
* Is emitted if the name filter has been changed by
* ViewModeController::setNameFilter().
*/
void nameFilterChanged(const QString& nameFilter);
/**
* Is emitted if the zoom level has been changed by
* ViewModeController::setZoomLevel().
*/
void zoomLevelChanged(int level);
/**
* Is emitted if pending previews should be canceled (e. g. because of an URL change).
*/
void cancelPreviews();
private:
int m_zoomLevel;
QString m_nameFilter;
KUrl m_url;
};
#endif
|
