HAL
settings_widget.h
Go to the documentation of this file.
1 // MIT License
2 //
3 // Copyright (c) 2019 Ruhr University Bochum, Chair for Embedded Security. All Rights reserved.
4 // Copyright (c) 2019 Marc Fyrbiak, Sebastian Wallat, Max Hoffmann ("ORIGINAL AUTHORS"). All rights reserved.
5 // Copyright (c) 2021 Max Planck Institute for Security and Privacy. All Rights reserved.
6 // Copyright (c) 2021 Jörn Langheinrich, Julian Speith, Nils Albartus, René Walendy, Simon Klix ("ORIGINAL AUTHORS"). All Rights reserved.
7 //
8 // Permission is hereby granted, free of charge, to any person obtaining a copy
9 // of this software and associated documentation files (the "Software"), to deal
10 // in the Software without restriction, including without limitation the rights
11 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 // copies of the Software, and to permit persons to whom the Software is
13 // furnished to do so, subject to the following conditions:
14 //
15 // The above copyright notice and this permission notice shall be included in all
16 // copies or substantial portions of the Software.
17 //
18 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 // SOFTWARE.
25 
26 #pragma once
27 
28 #include <QVariant>
29 #include <QToolButton>
30 #include <QBoxLayout>
31 #include <QFrame>
32 #include <QPair>
33 
34 class QColor;
35 class QLabel;
36 class QRegularExpression;
37 class QVBoxLayout;
38 
39 namespace hal
40 {
41  class SettingsItem;
42 
52  class SettingsWidget : public QFrame
53  {
54  Q_OBJECT
55  Q_PROPERTY(bool dirty READ dirty WRITE setDirty)
56 
57  public:
64  explicit SettingsWidget(SettingsItem* item, QWidget* parent = nullptr);
65 
69  void reset_labels();
70 
77  bool matchLabel(const QString& needle);
78 
82 
88  bool dirty() const;
90 
95  void prepare();
96 
102  const SettingsItem* settingsItem() const { return mSettingsItem; }
103 
107  virtual void acceptValue();
108 
112  virtual void loadCurrentValue();
113 
119  virtual void load(const QVariant& value) = 0;
120 
126  virtual QVariant value() = 0;
127 
131  virtual void clearEditor() {;}
132 
133  QString getLabel();
134 
135  public Q_SLOTS:
136 
141  virtual void handleRevertModification();
142 
148  virtual void handleSetDefaultValue(bool setAll=false);
149 
155  void handleItemDestroyed();
156 
157  Q_SIGNALS:
158 
162  void valueChanged();
163 
170 
176 
177  protected:
178 
182 
188  void setDirty(bool dirty);
190 
196 
202  void enterEvent(QEvent* event);
203 
209  void leaveEvent(QEvent* event);
210 
217 
220 
221  private:
222  bool mDirty = false;
223  };
224 }
The interface for the logical part of a setting.
Definition: settings_item.h:46
The base class for all specific SettingsWidgets.
virtual void loadCurrentValue()
QToolButton * mRevertButton
void setDirty(bool dirty)
Sets the dirty state.
QHBoxLayout * m_top_bar
void leaveEvent(QEvent *event)
QVBoxLayout * m_layout
SettingsWidget(SettingsItem *item, QWidget *parent=nullptr)
virtual void clearEditor()
QList< QPair< QLabel *, QString > > m_labels
void enterEvent(QEvent *event)
virtual void acceptValue()
QToolButton * mDefaultButton
virtual void handleSetDefaultValue(bool setAll=false)
SettingsItem * mSettingsItem
void triggerRemoveWidget(SettingsWidget *widget)
void triggerDescriptionUpdate(SettingsItem *item)
const SettingsItem * settingsItem() const
QBoxLayout * mContainer
virtual QVariant value()=0
virtual void handleRevertModification()
bool matchLabel(const QString &needle)
virtual void load(const QVariant &value)=0
virtual bool event(QEvent *e) override
Q_OBJECTQ_OBJECT
Q_PROPERTY(...)
Q_SIGNALSQ_SIGNALS
Q_SLOTSQ_SLOTS
QObject * parent() const const