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
|
/* === This file is part of Calamares - <https://github.com/calamares> ===
*
* Copyright 2014-2015, Teo Mrnjavac <teo@kde.org>
* Copyright 2017-2018, Adriaan de Groot <groot@kde.org>
*
* Calamares 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 3 of the License, or
* (at your option) any later version.
*
* Calamares 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 Calamares. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef VIEWMANAGER_H
#define VIEWMANAGER_H
#include "UiDllMacro.h"
#include "Typedefs.h"
#include <QList>
#include <QPushButton>
#include <QStackedWidget>
namespace Calamares
{
class ViewStep;
class ExecutionViewStep;
/**
* @brief The ViewManager class handles progression through view pages.
* @note Singleton object, only use through ViewManager::instance().
*/
class UIDLLEXPORT ViewManager : public QObject
{
Q_OBJECT
public:
/**
* @brief instance access to the ViewManager singleton.
* @return pointer to the singleton instance.
*/
static ViewManager* instance();
static ViewManager* instance( QObject* parent );
/**
* @brief centralWidget always returns the central widget in the Calamares main
* window.
* @return a pointer to the active QWidget (usually a wizard page provided by a
* view module).
*/
QWidget* centralWidget();
/**
* @brief addViewStep appends a view step to the roster.
* @param step a pointer to the ViewStep object to add.
* @note a ViewStep is the active instance of a view module, it aggregates one
* or more view pages, plus zero or more jobs which may be created at runtime.
*/
void addViewStep( ViewStep* step );
/**
* @brief viewSteps returns the list of currently present view steps.
* @return the ViewStepList.
* This should only return an empty list before startup is complete.
*/
ViewStepList viewSteps() const;
/**
* @brief currentStep returns the currently active ViewStep, i.e. the ViewStep
* which owns the currently visible view page.
* @return the active ViewStep. Do not confuse this with centralWidget().
* @see ViewStep::centralWidget
*/
ViewStep* currentStep() const;
/**
* @brief currentStepIndex returns the index of the currently active ViewStep.
* @return the index.
*/
int currentStepIndex() const;
/**
* @ brief Called when "Cancel" is clicked; asks for confirmation.
* Other means of closing Calamares also call this method, e.g. alt-F4.
* At the end of installation, no confirmation is asked. Returns true
* if the user confirms closing the window.
*/
bool confirmCancelInstallation();
public slots:
/**
* @brief next moves forward to the next page of the current ViewStep (if any),
* or to the first page of the next ViewStep if the current ViewStep doesn't
* have any more pages.
*/
void next();
/**
* @brief back moves backward to the previous page of the current ViewStep (if any),
* or to the last page of the previous ViewStep if the current ViewStep doesn't
* have any pages before the current one.
*/
void back();
/**
* @brief onInstallationFailed displays an error message when a fatal failure
* happens in a ViewStep.
* @param message the error string.
* @param details the details string.
*/
void onInstallationFailed( const QString& message, const QString& details );
/** @brief Replaces the stack with a view step stating that initialization failed.
*
* @param modules a list of failed modules.
*/
void onInitFailed( const QStringList& modules );
signals:
void currentStepChanged();
void enlarge( QSize enlarge ) const; // See ViewStep::enlarge()
private:
explicit ViewManager( QObject* parent = nullptr );
virtual ~ViewManager() override;
void insertViewStep( int before, ViewStep* step );
void updateButtonLabels();
static ViewManager* s_instance;
ViewStepList m_steps;
int m_currentStep;
QWidget* m_widget;
QStackedWidget* m_stack;
QPushButton* m_back;
QPushButton* m_next;
QPushButton* m_quit;
};
}
#endif // VIEWMANAGER_H
|
