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 
74 
80  bool dirty() const;
82 
87  void prepare();
88 
94  const SettingsItem* settingsItem() const { return mSettingsItem; }
95 
99  virtual void acceptValue();
100 
104  virtual void loadCurrentValue();
105 
111  virtual void load(const QVariant& value) = 0;
112 
118  virtual QVariant value() = 0;
119 
123  virtual void clearEditor() {;}
124 
125  QString getLabel();
126 
127  public Q_SLOTS:
128 
133  virtual void handleRevertModification();
134 
140  virtual void handleSetDefaultValue(bool setAll=false);
141 
147  void handleItemDestroyed();
148 
149  Q_SIGNALS:
150 
154  void valueChanged();
155 
162 
168 
169  protected:
170 
174 
180  void setDirty(bool dirty);
182 
188 
194  void enterEvent(QEvent* event);
195 
201  void leaveEvent(QEvent* event);
202 
209 
212 
213  private:
214  bool mDirty = false;
215  };
216 }
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()
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