OpenMS
ParamEditor.h
Go to the documentation of this file.
1 // Copyright (c) 2002-present, The OpenMS Team -- EKU Tuebingen, ETH Zurich, and FU Berlin
2 // SPDX-License-Identifier: BSD-3-Clause
3 //
4 // --------------------------------------------------------------------------
5 // $Maintainer: Timo Sachsenberg $
6 // $Authors: Marc Sturm, Chris Bielow $
7 // --------------------------------------------------------------------------
8 
9 #pragma once
10 
11 // OpenMS_GUI config
12 #include <OpenMS/VISUAL/OpenMS_GUIConfig.h>
13 
14 #include <OpenMS/CONCEPT/Types.h>
15 
16 #include <QtWidgets/QLineEdit>
17 #include <QtWidgets/QItemDelegate>
18 #include <QtWidgets/QTreeWidget>
19 
20 class QModelIndex;
21 class QStyleOptionViewItem;
22 class QAbstractItemModel;
23 #include <QtCore/qcontainerfwd.h> // for QStringList
24 class QString;
25 
26 namespace Ui
27 {
28  class ParamEditorTemplate;
29 }
30 
31 namespace OpenMS
32 {
33  class String;
34  class Param;
35  class ParamEditor;
40  namespace Internal
41  {
42 
47  class OPENMS_GUI_DLLAPI OpenMSLineEdit
48  : public QLineEdit
49  {
50  Q_OBJECT
51  public:
53  :QLineEdit(w)
54  {}
55 
56 signals:
58  void lostFocus();
59 
60 
61  protected:
62  void focusOutEvent ( QFocusEvent * e ) override;
63  void focusInEvent ( QFocusEvent * e ) override;
64  };
70  class OPENMS_GUI_DLLAPI ParamEditorDelegate :
71  public QItemDelegate
72  {
73  Q_OBJECT
74 
75 public:
79  QWidget * createEditor(QWidget * parent, const QStyleOptionViewItem & option, const QModelIndex & index) const override;
81  void setEditorData(QWidget * editor, const QModelIndex & index) const override;
83  void setModelData(QWidget * editor, QAbstractItemModel * model, const QModelIndex & index) const override;
85  void updateEditorGeometry(QWidget * editor, const QStyleOptionViewItem & option, const QModelIndex & index) const override;
86 
88  bool hasUncommittedData() const;
89 signals:
91  void modified(bool) const;
92 
93 protected:
95  bool eventFilter(QObject* editor, QEvent* event) override;
96 
97 private slots:
101  void closeEditor_();
104 
105 private:
109  mutable QString fileName_;
111  mutable QString dirName_;
113  mutable bool has_uncommited_data_;
114  };
115 
117  class OPENMS_GUI_DLLAPI ParamTree :
118  public QTreeWidget
119  {
120  Q_OBJECT
121 
122 public:
124  ParamTree(QWidget * parent);
126  bool edit(const QModelIndex & index, EditTrigger trigger, QEvent * event) override;
127 
128 signals:
130  void selected(const QModelIndex & index);
131 
132 protected slots:
134  void selectionChanged(const QItemSelection & selected, const QItemSelection &) override;
135  };
136 
137  }
138 
139 
151  class OPENMS_GUI_DLLAPI ParamEditor :
152  public QWidget
153  {
154  Q_OBJECT
155 
156 public:
158  enum
159  {
162  ADVANCED_ITEM
163  };
164 
166  ParamEditor(QWidget* parent = nullptr);
168  ~ParamEditor() override;
169 
171  void load(Param& param);
173  void store();
175  bool isModified() const;
177  void clear();
178 
179 public slots:
182  void setModified(bool is_modified);
183 
184 signals:
186  void modified(bool);
187 
188 protected slots:
190  void toggleAdvancedMode(bool advanced);
192  void showDocumentation(const QModelIndex & index);
193 
194 protected:
196  void storeRecursive_(QTreeWidgetItem * child, String path, std::map<String, String> & section_descriptions);
197 
203  bool modified_;
206 
207 private:
208  Ui::ParamEditorTemplate* ui_;
209  };
210 
211 
212 } // namespace OpenMS
213 
Custom QLineEdit which emits a signal when losing focus (such that we can commit its data)
Definition: ParamEditor.h:49
void focusInEvent(QFocusEvent *e) override
void lostFocus()
emitted on focusOutEvent
void focusOutEvent(QFocusEvent *e) override
OpenMSLineEdit(QWidget *w)
Definition: ParamEditor.h:52
Internal delegate class for QTreeWidget.
Definition: ParamEditor.h:72
ParamEditorDelegate(QObject *parent)
Constructor.
void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const override
Updates the editor for the item specified by index according to the style option given.
void closeEditor_()
if cancel in any editor is clicked, the Dialog is closed and changes are rejected
void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override
Sets the data for the specified model and item index from that supplied by the editor....
QWidget * createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override
Returns the widget(combobox or QLineEdit) used to edit the item specified by index for editing....
bool hasUncommittedData() const
true if the underlying tree has an open QLineEdit which has uncommitted data
bool has_uncommited_data_
true if a QLineEdit is still open and has not committed its data yet (so storing the current param is...
Definition: ParamEditor.h:113
void commitAndCloseEditor_()
For closing any editor and updating ParamEditor.
QString dirName_
holds a directory name (for output directories)
Definition: ParamEditor.h:111
QString fileName_
used to modify value of output and input files( not for output and input lists)
Definition: ParamEditor.h:109
void commitAndCloseLineEdit_()
... a bit special, because reset uncommited data
void modified(bool) const
signal for showing ParamEditor if the Model data changed
bool eventFilter(QObject *editor, QEvent *event) override
a shortcut to calling commit(), which calls setModelData(); useful for embedded editors,...
void setEditorData(QWidget *editor, const QModelIndex &index) const override
Sets the data to be displayed and edited by the editor for the item specified by index.
QTreeWidget that emits a signal whenever a new row is selected.
Definition: ParamEditor.h:119
void selected(const QModelIndex &index)
Signal that is emitted when a new item is selected.
ParamTree(QWidget *parent)
Constructor.
bool edit(const QModelIndex &index, EditTrigger trigger, QEvent *event) override
Overloaded edit method to activate F2 use.
void selectionChanged(const QItemSelection &selected, const QItemSelection &) override
Reimplemented virtual slot.
A GUI for editing or viewing a Param object.
Definition: ParamEditor.h:153
Internal::ParamTree * tree_
Pointer to the tree widget.
Definition: ParamEditor.h:199
bool advanced_mode_
Indicates if normal mode or advanced mode is activated.
Definition: ParamEditor.h:205
void storeRecursive_(QTreeWidgetItem *child, String path, std::map< String, String > &section_descriptions)
recursive helper method for method storeRecursive()
void showDocumentation(const QModelIndex &index)
Shows the documentation of an item in doc_.
void load(Param &param)
load method for Param object
bool isModified() const
Indicates if the data changed since last save.
bool modified_
Indicates that the data was modified since last store/load operation.
Definition: ParamEditor.h:203
Ui::ParamEditorTemplate * ui_
Definition: ParamEditor.h:208
@ NODE
Section.
Definition: ParamEditor.h:160
@ NORMAL_ITEM
Item that is always shown.
Definition: ParamEditor.h:161
void setModified(bool is_modified)
void toggleAdvancedMode(bool advanced)
Switches between normal and advanced mode.
void modified(bool)
item was edited
Param * param_
The data to edit.
Definition: ParamEditor.h:201
ParamEditor(QWidget *parent=nullptr)
constructor
void clear()
Clears all parameters.
~ParamEditor() override
destructor
void store()
store edited data in Param object
Management and storage of parameters / INI files.
Definition: Param.h:44
A more convenient string class.
Definition: String.h:34
Main OpenMS namespace.
Definition: openswathalgo/include/OpenMS/OPENSWATHALGO/DATAACCESS/ISpectrumAccess.h:19
Definition: FLASHDeconvWizardBase.h:37