blob: f4801b7c7341acb9de50b87be685609dff3bbf82 (
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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
#pragma once
#include <coreplugin/core_global.h>
#include <utils/aspects.h>
#include <utils/icon.h>
#include <utils/id.h>
#include <QObject>
#include <QPointer>
#include <QStringList>
#include <QWidget>
#include <functional>
namespace Layouting { class LayoutItem; };
namespace Utils { class AspectContainer; };
namespace Core {
class CORE_EXPORT IOptionsPageWidget : public QWidget
{
Q_OBJECT
public:
void setOnApply(const std::function<void ()> &func) { m_onApply = func; }
void setOnFinish(const std::function<void ()> &func) { m_onFinish = func; }
protected:
friend class IOptionsPage;
virtual void apply() { if (m_onApply) m_onApply(); }
virtual void finish() { if (m_onFinish) m_onFinish(); }
private:
std::function<void()> m_onApply;
std::function<void()> m_onFinish;
};
class CORE_EXPORT IOptionsPage
{
Q_DISABLE_COPY_MOVE(IOptionsPage)
public:
explicit IOptionsPage(bool registerGlobally = true);
virtual ~IOptionsPage();
static const QList<IOptionsPage *> allOptionsPages();
Utils::Id id() const { return m_id; }
QString displayName() const { return m_displayName; }
Utils::Id category() const { return m_category; }
QString displayCategory() const { return m_displayCategory; }
QIcon categoryIcon() const;
using WidgetCreator = std::function<IOptionsPageWidget *()>;
void setWidgetCreator(const WidgetCreator &widgetCreator);
QStringList keywords() const;
virtual bool matches(const QRegularExpression ®exp) const;
virtual QWidget *widget();
virtual void apply();
virtual void finish();
protected:
void setId(Utils::Id id) { m_id = id; }
void setDisplayName(const QString &displayName) { m_displayName = displayName; }
void setCategory(Utils::Id category) { m_category = category; }
void setDisplayCategory(const QString &displayCategory) { m_displayCategory = displayCategory; }
void setCategoryIcon(const Utils::Icon &categoryIcon) { m_categoryIcon = categoryIcon; }
void setCategoryIconPath(const Utils::FilePath &categoryIconPath);
void setSettings(Utils::AspectContainer *settings);
void setLayouter(const std::function<Layouting::LayoutItem()> &layouter);
// Used in FontSettingsPage. FIXME?
QPointer<QWidget> m_widget; // Used in conjunction with m_widgetCreator
private:
Utils::Id m_id;
Utils::Id m_category;
QString m_displayName;
QString m_displayCategory;
Utils::Icon m_categoryIcon;
WidgetCreator m_widgetCreator;
mutable bool m_keywordsInitialized = false;
mutable QStringList m_keywords;
Utils::AspectContainer *m_settings = nullptr;
};
/*
Alternative way for providing option pages instead of adding IOptionsPage
objects into the plugin manager pool. Should only be used if creation of the
actual option pages is not possible or too expensive at Qt Creator startup.
(Like the designer integration, which needs to initialize designer plugins
before the options pages get available.)
*/
class CORE_EXPORT IOptionsPageProvider
{
Q_DISABLE_COPY_MOVE(IOptionsPageProvider);
public:
IOptionsPageProvider();
virtual ~IOptionsPageProvider();
static const QList<IOptionsPageProvider *> allOptionsPagesProviders();
Utils::Id category() const { return m_category; }
QString displayCategory() const { return m_displayCategory; }
QIcon categoryIcon() const;
virtual QList<IOptionsPage *> pages() const = 0;
virtual bool matches(const QRegularExpression ®exp) const = 0;
protected:
void setCategory(Utils::Id category) { m_category = category; }
void setDisplayCategory(const QString &displayCategory) { m_displayCategory = displayCategory; }
void setCategoryIcon(const Utils::Icon &categoryIcon) { m_categoryIcon = categoryIcon; }
Utils::Id m_category;
QString m_displayCategory;
Utils::Icon m_categoryIcon;
};
class CORE_EXPORT PagedSettings : public Utils::AspectContainer, public IOptionsPage
{
public:
PagedSettings();
using AspectContainer::readSettings; // FIXME: Remove.
void readSettings(); // Intentionally hides AspectContainer::readSettings()
};
} // namespace Core
|
