Settings: About: alpha-sort list of protocol decoders
[pulseview.git] / pv / globalsettings.hpp
1 /*
2  * This file is part of the PulseView project.
3  *
4  * Copyright (C) 2017 Soeren Apel <soeren@apelpie.net>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef PULSEVIEW_GLOBALSETTINGS_HPP
21 #define PULSEVIEW_GLOBALSETTINGS_HPP
22
23 #include <functional>
24 #include <map>
25
26 #include <QSettings>
27 #include <QString>
28 #include <QVariant>
29
30 using std::function;
31 using std::map;
32 using std::multimap;
33
34 namespace pv {
35
36 class GlobalSettings : public QSettings
37 {
38         Q_OBJECT
39
40 public:
41         static const QString Key_View_AlwaysZoomToFit;
42         static const QString Key_View_ColouredBG;
43         static const QString Key_View_StickyScrolling;
44         static const QString Key_View_ShowSamplingPoints;
45         static const QString Key_View_ShowAnalogMinorGrid;
46
47 public:
48         GlobalSettings();
49
50         static void register_change_handler(const QString key,
51                 function<void(QVariant)> cb);
52
53         void setValue(const QString& key, const QVariant& value);
54
55         /**
56          * Begins the tracking of changes. All changes will
57          * be recorded until stop_tracking() is called.
58          * The change tracking is global and doesn't support nesting.
59          */
60         void start_tracking();
61
62         /**
63          * Ends the tracking of changes without any changes to the settings.
64          */
65         void stop_tracking();
66
67         /**
68          * Ends the tracking of changes, undoing the changes since the
69          * change tracking began.
70          */
71         void undo_tracked_changes();
72
73 private:
74         static multimap< QString, function<void(QVariant)> > callbacks_;
75
76         static bool tracking_;
77         static map<QString, QVariant> tracked_changes_;
78 };
79
80 } // namespace pv
81
82 #endif // PULSEVIEW_GLOBALSETTINGS_HPP