QGIS API Documentation 3.30.0-'s-Hertogenbosch (f186b8efe0)
Public Member Functions | Protected Member Functions | List of all members
QgsSettingsEntryByValue< T > Class Template Referenceabstract

Base abstract class for settings entry which are passed by value. More...

#include <qgssettingsentry.h>

Inheritance diagram for QgsSettingsEntryByValue< T >:
Inheritance graph
[legend]

Public Member Functions

 QgsSettingsEntryByValue (const QString &key, const QString &section, QVariant defaultValue, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions())
 Constructor for QgsSettingsEntryByValue. More...
 
 QgsSettingsEntryByValue (const QString &key, QgsSettingsTreeNode *parent, QVariant defaultValue, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions())
 Constructor for QgsSettingsEntryByValue. More...
 
defaultValue () const
 Returns settings default value. More...
 
formerValue (const QString &dynamicKeyPart=QString()) const
 Returns the former value Returns the current value (or default) if there is no former value. More...
 
formerValue (const QStringList &dynamicKeyPartList) const
 Returns the former value Returns the current value (or default) if there is no former value. More...
 
virtual Qgis::SettingsType settingsType () const override=0
 Returns the settings entry type. More...
 
bool setValue (T value, const QString &dynamicKeyPart=QString()) const
 Set settings value. More...
 
bool setValue (T value, const QStringList &dynamicKeyPartList) const
 Set settings value. More...
 
Q_DECL_DEPRECATED T value (const QString &dynamicKeyPart, bool useDefaultValueOverride, T defaultValueOverride) const
 Returns the settings value for the dynamicKeyPart and with a defaultValueOverride. More...
 
value (const QString &dynamicKeyPart=QString()) const
 Returns settings value. More...
 
value (const QStringList &dynamicKeyPartList) const
 Returns settings value. More...
 
Q_DECL_DEPRECATED T value (const QStringList &dynamicKeyPartList, bool useDefaultValueOverride, T defaultValueOverride) const
 Returns the settings value for the dynamicKeyPartList and with a defaultValueOverride. More...
 
valueWithDefaultOverride (T defaultValueOverride, const QString &dynamicKeyPart=QString()) const
 Returns the settings value with a defaultValueOverride and with an optional dynamicKeyPart. More...
 
valueWithDefaultOverride (T defaultValueOverride, const QStringList &dynamicKeyPartList) const
 Returns the settings value with a defaultValueOverride for the dynamicKeyPartList. More...
 
- Public Member Functions inherited from QgsSettingsEntryBase
 QgsSettingsEntryBase (const QString &key, const QString &section, const QVariant &defaultValue=QVariant(), const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions())
 Constructor for QgsSettingsEntryBase. More...
 
 QgsSettingsEntryBase (const QString &name, QgsSettingsTreeNode *parent, const QVariant &defaultValue=QVariant(), const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions()) SIP_THROW(QgsSettingsException)
 Constructor for QgsSettingsEntryBase. More...
 
virtual ~QgsSettingsEntryBase ()
 Destructor for QgsSettingsEntryBase. More...
 
bool copyValueFromKey (const QString &key, bool removeSettingAtKey=false) const
 Copies the value from a given key if it exists. More...
 
bool copyValueFromKey (const QString &key, const QStringList &dynamicKeyPartList, bool removeSettingAtKey=false) const
 Copies the value from a given key if it exists. More...
 
void copyValueToKey (const QString &key, const QStringList &dynamicKeyPartList=QStringList()) const
 Copies the settings to the given key. More...
 
QVariant defaultValueAsVariant () const
 Returns settings default value. More...
 
QString definitionKey () const
 Returns settings entry defining key. More...
 
QString description () const
 Returns the settings entry description. More...
 
bool exists (const QString &dynamicKeyPart=QString()) const
 Returns true if the settings is contained in the underlying QSettings. More...
 
bool exists (const QStringList &dynamicKeyPartList) const
 Returns true if the settings is contained in the underlying QSettings. More...
 
QVariant formerValueAsVariant (const QString &dynamicKeyPart) const
 Returns the former value of the settings if it has been enabled in the options. More...
 
QVariant formerValueAsVariant (const QStringList &dynamicKeyPartList) const
 Returns the former value of the settings if it has been enabled in the options Returns the current value (or default) if there is no former value. More...
 
bool hasDynamicKey () const
 Returns true if a part of the settings key is built dynamically. More...
 
QString key (const QString &dynamicKeyPart=QString()) const
 Returns settings entry key. More...
 
QString key (const QStringList &dynamicKeyPartList) const
 Returns settings entry key. More...
 
bool keyIsValid (const QString &key) const
 Returns true if the provided key match the settings entry. More...
 
QString name () const
 Returns the name of the settings. More...
 
Qgis::SettingsOptions options () const
 Returns the settings options. More...
 
Qgis::SettingsOrigin origin (const QStringList &dynamicKeyPartList) const
 Returns the origin of the setting if it exists. More...
 
QgsSettingsTreeNodeparent () const
 Returns the parent tree element. More...
 
void remove (const QString &dynamicKeyPart=QString()) const
 Removes the settings from the underlying QSettings. More...
 
void remove (const QStringList &dynamicKeyPartList) const
 Removes the settings from the underlying QSettings. More...
 
Q_DECL_DEPRECATED int section () const
 Returns settings section. More...
 
virtual Qgis::SettingsType settingsType () const
 Returns the settings entry type. More...
 
virtual Q_DECL_DEPRECATED bool setVariantValue (const QVariant &value, const QString &dynamicKeyPart=QString()) const
 Set settings value. More...
 
virtual Q_DECL_DEPRECATED bool setVariantValue (const QVariant &value, const QStringList &dynamicKeyPartList) const
 Set settings value. More...
 
Q_DECL_DEPRECATED QVariant valueAsVariant (const QString &dynamicKeyPart, bool useDefaultValueOverride, const QVariant &defaultValueOverride) const
 Returns settings value with an optional default value override. More...
 
QVariant valueAsVariant (const QString &dynamicKeyPart=QString()) const
 Returns settings value with. More...
 
QVariant valueAsVariant (const QStringList &dynamicKeyPartList) const
 Returns settings value with. More...
 
Q_DECL_DEPRECATED QVariant valueAsVariant (const QStringList &dynamicKeyPartList, bool useDefaultValueOverride, const QVariant &defaultValueOverride) const
 Returns settings value with an optional default value override. More...
 
QVariant valueAsVariantWithDefaultOverride (const QVariant &defaultValueOverride, const QString &dynamicKeyPart=QString()) const
 Returns settings value with a defaultValueOverride. More...
 
QVariant valueAsVariantWithDefaultOverride (const QVariant &defaultValueOverride, const QStringList &dynamicKeyPartList) const
 Returns settings value. More...
 

Protected Member Functions

virtual bool checkValue (T value) const
 Check if the value is valid. More...
 
virtual T convertFromVariant (const QVariant &value) const =0
 Converts the variant value to the value type of the setting. More...
 
virtual QVariant convertToVariant (T value) const
 Converts the value to a variant. More...
 
virtual bool setValuePrivate (T value, const QStringList &dynamicKeyPartList) const
 Sets the settings value with an optional list of dynamic parts. More...
 
- Protected Member Functions inherited from QgsSettingsEntryBase
bool setVariantValuePrivate (const QVariant &value, const QStringList &dynamicKeyPartList=QStringList()) const
 Sets the settings value with a variant value. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from QgsSettingsEntryBase
static QStringList dynamicKeyPartToList (const QString &dynamicKeyPart)
 Transforms a dynamic key part string to list. More...
 

Detailed Description

template<class T>
class QgsSettingsEntryByValue< T >

Base abstract class for settings entry which are passed by value.

See also
QgsSettingsEntryBase
QgsSettingsEntryByReference
Since
QGIS 3.26

Definition at line 531 of file qgssettingsentry.h.

Constructor & Destructor Documentation

◆ QgsSettingsEntryByValue() [1/2]

template<class T >
QgsSettingsEntryByValue< T >::QgsSettingsEntryByValue ( const QString &  key,
QgsSettingsTreeNode parent,
QVariant  defaultValue,
const QString &  description = QString(),
Qgis::SettingsOptions  options = Qgis::SettingsOptions() 
)
inline

Constructor for QgsSettingsEntryByValue.

Parameters
keyspecifies the key of the settings.
parentspecifies the parent in the tree of settings.
defaultValuespecifies the default value for the settings entry.
descriptionspecifies a description for the settings entry.
optionsspecifies the options for the settings entry.
Exceptions
QgsSettingsExceptionif the number of given parent named items doesn't match the complete key definition

Definition at line 545 of file qgssettingsentry.h.

◆ QgsSettingsEntryByValue() [2/2]

template<class T >
QgsSettingsEntryByValue< T >::QgsSettingsEntryByValue ( const QString &  key,
const QString &  section,
QVariant  defaultValue,
const QString &  description = QString(),
Qgis::SettingsOptions  options = Qgis::SettingsOptions() 
)
inline

Constructor for QgsSettingsEntryByValue.

Parameters
keyspecifies the key of the settings.
sectionspecifies the section.
defaultValuespecifies the default value for the settings entry.
descriptionspecifies a description for the settings entry.
optionsspecifies the options for the settings entry.

Definition at line 558 of file qgssettingsentry.h.

Member Function Documentation

◆ checkValue()

template<class T >
virtual bool QgsSettingsEntryByValue< T >::checkValue ( value) const
inlineprotectedvirtual

Check if the value is valid.

Definition at line 671 of file qgssettingsentry.h.

◆ convertFromVariant()

template<class T >
virtual T QgsSettingsEntryByValue< T >::convertFromVariant ( const QVariant &  value) const
protectedpure virtual

◆ convertToVariant()

template<class T >
virtual QVariant QgsSettingsEntryByValue< T >::convertToVariant ( value) const
inlineprotectedvirtual

◆ defaultValue()

template<class T >
T QgsSettingsEntryByValue< T >::defaultValue ( ) const
inline

Returns settings default value.

Definition at line 637 of file qgssettingsentry.h.

◆ formerValue() [1/2]

template<class T >
T QgsSettingsEntryByValue< T >::formerValue ( const QString &  dynamicKeyPart = QString()) const
inline

Returns the former value Returns the current value (or default) if there is no former value.

Definition at line 643 of file qgssettingsentry.h.

◆ formerValue() [2/2]

template<class T >
T QgsSettingsEntryByValue< T >::formerValue ( const QStringList &  dynamicKeyPartList) const
inline

Returns the former value Returns the current value (or default) if there is no former value.

Definition at line 649 of file qgssettingsentry.h.

◆ settingsType()

template<class T >
virtual Qgis::SettingsType QgsSettingsEntryByValue< T >::settingsType ( ) const
overridepure virtual

◆ setValue() [1/2]

template<class T >
bool QgsSettingsEntryByValue< T >::setValue ( value,
const QString &  dynamicKeyPart = QString() 
) const
inline

Set settings value.

Parameters
valuespecifies the value to set.
dynamicKeyPartspecifies the dynamic part of the settings key.

Definition at line 620 of file qgssettingsentry.h.

◆ setValue() [2/2]

template<class T >
bool QgsSettingsEntryByValue< T >::setValue ( value,
const QStringList &  dynamicKeyPartList 
) const
inline

Set settings value.

Parameters
valuespecifies the value to set.
dynamicKeyPartListspecifies the list of dynamic parts of the settings key.

Definition at line 631 of file qgssettingsentry.h.

◆ setValuePrivate()

template<class T >
virtual bool QgsSettingsEntryByValue< T >::setValuePrivate ( value,
const QStringList &  dynamicKeyPartList 
) const
inlineprotectedvirtual

◆ value() [1/4]

template<class T >
Q_DECL_DEPRECATED T QgsSettingsEntryByValue< T >::value ( const QString &  dynamicKeyPart,
bool  useDefaultValueOverride,
defaultValueOverride 
) const
inline

Returns the settings value for the dynamicKeyPart and with a defaultValueOverride.

Deprecated:
since QGIS 3.26 use valueWithDefaultOverride instead

Definition at line 594 of file qgssettingsentry.h.

◆ value() [2/4]

template<class T >
T QgsSettingsEntryByValue< T >::value ( const QString &  dynamicKeyPart = QString()) const
inline

Returns settings value.

Parameters
dynamicKeyPartspecifies the dynamic part of the settings key.

Definition at line 569 of file qgssettingsentry.h.

◆ value() [3/4]

template<class T >
T QgsSettingsEntryByValue< T >::value ( const QStringList &  dynamicKeyPartList) const
inline

Returns settings value.

Parameters
dynamicKeyPartListspecifies the list of dynamic parts of the settings key.

Definition at line 576 of file qgssettingsentry.h.

◆ value() [4/4]

template<class T >
Q_DECL_DEPRECATED T QgsSettingsEntryByValue< T >::value ( const QStringList &  dynamicKeyPartList,
bool  useDefaultValueOverride,
defaultValueOverride 
) const
inline

Returns the settings value for the dynamicKeyPartList and with a defaultValueOverride.

Deprecated:
since QGIS 3.26 use valueWithDefaultOverride instead

Definition at line 606 of file qgssettingsentry.h.

◆ valueWithDefaultOverride() [1/2]

template<class T >
T QgsSettingsEntryByValue< T >::valueWithDefaultOverride ( defaultValueOverride,
const QString &  dynamicKeyPart = QString() 
) const
inline

Returns the settings value with a defaultValueOverride and with an optional dynamicKeyPart.

Definition at line 579 of file qgssettingsentry.h.

◆ valueWithDefaultOverride() [2/2]

template<class T >
T QgsSettingsEntryByValue< T >::valueWithDefaultOverride ( defaultValueOverride,
const QStringList &  dynamicKeyPartList 
) const
inline

Returns the settings value with a defaultValueOverride for the dynamicKeyPartList.

Definition at line 585 of file qgssettingsentry.h.


The documentation for this class was generated from the following file: