X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=src%2Fuisupport%2Fsettingspage.h;h=11555e5b10fb54fc2682344c9cb3abbf33660b65;hp=ccd93fbae71cd9170343960cd2f713cfed9bcbd4;hb=HEAD;hpb=9d54503555534a2c554f09a33df6afa33d6308ec

diff --git a/src/uisupport/settingspage.h b/src/uisupport/settingspage.h
index ccd93fba..5b1199ac 100644
--- a/src/uisupport/settingspage.h
+++ b/src/uisupport/settingspage.h
@@ -1,5 +1,5 @@
 /***************************************************************************
- *   Copyright (C) 2005-2014 by the Quassel Project                        *
+ *   Copyright (C) 2005-2022 by the Quassel Project                        *
  *   devel@quassel-irc.org                                                 *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
@@ -18,14 +18,16 @@
  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.         *
  ***************************************************************************/
 
-#ifndef _SETTINGSPAGE_H_
-#define _SETTINGSPAGE_H_
+#pragma once
+
+#include "uisupport-export.h"
 
 #include <QWidget>
 
 class QCheckBox;
 class QComboBox;
 class QSpinBox;
+class FontSelector;
 
 //! A SettingsPage is a page in the settings dialog.
 /** The SettingsDlg provides suitable standard buttons, such as Ok, Apply, Cancel, Restore Defaults and Reset.
@@ -54,13 +56,12 @@ class QSpinBox;
  *    - QComboBox (currentIndex())
  *    - QSpinBox (value())
  */
-class SettingsPage : public QWidget
+class UISUPPORT_EXPORT SettingsPage : public QWidget
 {
     Q_OBJECT
 
 public:
-    SettingsPage(const QString &category, const QString &name, QWidget *parent = 0);
-    virtual ~SettingsPage() {};
+    SettingsPage(QString category, QString name, QWidget* parent = nullptr);
 
     //! The category of this settings page.
     inline virtual QString category() const { return _category; }
@@ -74,8 +75,15 @@ public:
      */
     inline virtual bool needsCoreConnection() const { return false; }
 
+    /**
+     * Whether the settingspage should be selectable or not, in a given situation
+     * Used for pages that should only be visible if certain features are available (or not).
+     * @return
+     */
+    inline virtual bool isSelectable() const { return true; }
+
     //! The key this settings page stores its values under
-    /** This needs to be overriden to enable automatic loading/saving/hasChanged checking of widgets.
+    /** This needs to be overridden to enable automatic loading/saving/hasChanged checking of widgets.
      *  The child widgets' values will be stored in client settings under this key. Every widget that
      *  should be automatically handled needs to have a \c settingsKey property set, and should also provide
      *  a \c defaultValue property.
@@ -89,7 +97,7 @@ public:
      *  enabled. You also need to provide an implementation of defaults() then.
      *
      * The default implementation returns false.
-       */
+     */
     inline virtual bool hasDefaults() const { return false; }
 
     //! Check if there are changes in the page, compared to the state saved in permanent storage.
@@ -101,13 +109,15 @@ public:
      */
     inline virtual bool aboutToSave() { return true; }
 
-    //! sets checked state depending on \checked and stores the value for later comparision
-    static void load(QCheckBox *box, bool checked);
-    static bool hasChanged(QCheckBox *box);
-    static void load(QComboBox *box, int index);
-    static bool hasChanged(QComboBox *box);
-    static void load(QSpinBox *box, int value);
-    static bool hasChanged(QSpinBox *box);
+    //! sets checked state depending on \checked and stores the value for later comparison
+    static void load(QCheckBox* box, bool checked);
+    static bool hasChanged(QCheckBox* box);
+    static void load(QComboBox* box, int index);
+    static bool hasChanged(QComboBox* box);
+    static void load(QSpinBox* box, int value);
+    static bool hasChanged(QSpinBox* box);
+    static void load(FontSelector* box, QFont value);
+    static bool hasChanged(FontSelector* box);
 
 public slots:
     //! Save settings to permanent storage.
@@ -129,16 +139,13 @@ public slots:
     virtual void defaults();
 
 protected slots:
-    //! Calling this slot is equivalent to calling setChangedState(true).
-    inline void changed() { setChangedState(true); }
-
     //! This should be called whenever the widget state changes from unchanged to change or the other way round.
     void setChangedState(bool hasChanged = true);
 
 protected:
     void initAutoWidgets();
-    virtual QVariant loadAutoWidgetValue(const QString &widgetName);
-    virtual void saveAutoWidgetValue(const QString &widgetName, const QVariant &value);
+    virtual QVariant loadAutoWidgetValue(const QString& widgetName);
+    virtual void saveAutoWidgetValue(const QString& widgetName, const QVariant& value);
 
 signals:
     //! Emitted whenever the widget state changes.
@@ -149,14 +156,11 @@ private slots:
     void autoWidgetHasChanged();
 
 private:
-    void findAutoWidgets(QObject *parent, QObjectList *widgetList) const;
-    QByteArray autoWidgetPropertyName(QObject *widget) const;
-    QString autoWidgetSettingsKey(QObject *widget) const;
+    void findAutoWidgets(QObject* parent, QObjectList* widgetList) const;
+    QByteArray autoWidgetPropertyName(QObject* widget) const;
+    QString autoWidgetSettingsKey(QObject* widget) const;
 
     QString _category, _title;
     bool _changed, _autoWidgetsChanged;
     QObjectList _autoWidgets;
 };
-
-
-#endif