QGIS API Documentation 3.32.0-Lima (311a8cb8a6)
Public Member Functions | List of all members
QgsSettingsEntryDouble Class Reference

A double settings entry. More...

#include <qgssettingsentryimpl.h>

Inheritance diagram for QgsSettingsEntryDouble:
Inheritance graph
[legend]

Public Member Functions

 QgsSettingsEntryDouble (const QString &key, const QString &section, double defaultValue=0.0, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions(), double minValue=std::numeric_limits< double >::lowest(), double maxValue=std::numeric_limits< double >::max(), int displayDecimals=1) SIP_THROW(QgsSettingsException) SIP_MAKE_PRIVATE
 Constructor for QgsSettingsEntryDouble. More...
 
 QgsSettingsEntryDouble (const QString &name, QgsSettingsTreeNode *parent, double defaultValue=0.0, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions(), double minValue=std::numeric_limits< double >::lowest(), double maxValue=std::numeric_limits< double >::max(), int displayDecimals=1) SIP_THROW(QgsSettingsException)
 Constructor for QgsSettingsEntryDouble. More...
 
double convertFromVariant (const QVariant &value) const override SIP_FORCE
 Converts the variant value to the value type of the setting. More...
 
int displayHintDecimals () const
 Returns how much decimals should be shown in the Gui. More...
 
double maxValue () const
 Returns the maximum value. More...
 
double minValue () const
 Returns the minimum value. More...
 
void setDisplayHintDecimals (int displayHintDecimals)
 Set the display hint decimals. More...
 
virtual Qgis::SettingsType settingsType () const override
 Returns the settings entry type. More...
 
- Public Member Functions inherited from QgsSettingsEntryBaseTemplate< double >
 QgsSettingsEntryBaseTemplate (const QString &key, const QString &section, const QVariant &defaultValue, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions())
 Constructor for QgsSettingsEntryByReference. More...
 
 QgsSettingsEntryBaseTemplate (const QString &name, QgsSettingsTreeNode *parent, const QVariant &defaultValue, const QString &description=QString(), Qgis::SettingsOptions options=Qgis::SettingsOptions())
 Constructor for QgsSettingsEntryByReference. More...
 
bool checkValueVariant (const QVariant &value) const override
 Returns true if the given value is valid towards the setting definition. More...
 
virtual double convertFromVariant (const QVariant &value) const=0
 Converts the variant value to the value type of the setting. More...
 
double defaultValue () const
 Returns settings default value. More...
 
double formerValue (const QString &dynamicKeyPart=QString()) const
 Returns the former value. More...
 
double 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 (const double &value, const QString &dynamicKeyPart=QString()) const
 Set settings value. More...
 
bool setValue (const double &value, const QStringList &dynamicKeyPartList) const
 Set settings value. More...
 
double value (const QString &dynamicKeyPart=QString()) const
 Returns settings value. More...
 
double value (const QStringList &dynamicKeyPartList) const
 Returns settings value. More...
 
double valueWithDefaultOverride (const double &defaultValueOverride, const QString &dynamicKeyPart=QString()) const
 Returns the settings value with a defaultValueOverride and with an optional dynamicKeyPart. More...
 
double valueWithDefaultOverride (const double &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...
 
virtual bool checkValueVariant (const QVariant &value) const
 Returns true if the given value is valid towards the setting definition. 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...
 
bool setVariantValue (const QVariant &value, const QString &dynamicKeyPart=QString()) const
 Set settings value. More...
 
bool setVariantValue (const QVariant &value, const QStringList &dynamicKeyPartList) const
 Set settings value. More...
 
virtual QString typeId () const
 Returns the id of the type of settings This can be re-implemented in a custom implementation of a setting. 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...
 

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...
 
- Protected Member Functions inherited from QgsSettingsEntryBaseTemplate< double >
virtual bool checkValuePrivate (const double &value) const
 Check if the value is valid. More...
 
virtual QVariant convertToVariant (const double &value) const
 Converts the value to a variant. More...
 
virtual bool setValuePrivate (const double &value, const QStringList &dynamicKeyPartList) const
 Sets the settings value with an optional list of dynamic parts. More...
 

Detailed Description

A double settings entry.

Since
QGIS 3.20

Definition at line 563 of file qgssettingsentryimpl.h.

Constructor & Destructor Documentation

◆ QgsSettingsEntryDouble() [1/2]

QgsSettingsEntryDouble::QgsSettingsEntryDouble ( const QString &  name,
QgsSettingsTreeNode parent,
double  defaultValue = 0.0,
const QString &  description = QString(),
Qgis::SettingsOptions  options = Qgis::SettingsOptions(),
double  minValue = std::numeric_limits<double>::lowest(),
double  maxValue = std::numeric_limits<double>::max(),
int  displayDecimals = 1 
)
inline

Constructor for QgsSettingsEntryDouble.

Parameters
namespecifies the name of the setting.
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.
minValuespecifies the minimal value.
maxValuespecifies the maximal value.
displayDecimalsspecifies a hint for the gui about how much decimals to show for example for a QDoubleSpinBox.

Definition at line 580 of file qgssettingsentryimpl.h.

◆ QgsSettingsEntryDouble() [2/2]

QgsSettingsEntryDouble::QgsSettingsEntryDouble ( const QString &  key,
const QString &  section,
double  defaultValue = 0.0,
const QString &  description = QString(),
Qgis::SettingsOptions  options = Qgis::SettingsOptions(),
double  minValue = std::numeric_limits<double>::lowest(),
double  maxValue = std::numeric_limits<double>::max(),
int  displayDecimals = 1 
)
inline

Constructor for QgsSettingsEntryDouble.

Parameters
keyspecifies the final part of the settings key.
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.
minValuespecifies the minimal value.
maxValuespecifies the maximal value.
displayDecimalsspecifies a hint for the gui about how much decimals to show for example for a QDoubleSpinBox.

Definition at line 607 of file qgssettingsentryimpl.h.

Member Function Documentation

◆ convertFromVariant()

double QgsSettingsEntryDouble::convertFromVariant ( const QVariant &  value) const
overridevirtual

Converts the variant value to the value type of the setting.

Implements QgsSettingsEntryBaseTemplate< double >.

Definition at line 195 of file qgssettingsentryimpl.cpp.

◆ displayHintDecimals()

int QgsSettingsEntryDouble::displayHintDecimals ( ) const

Returns how much decimals should be shown in the Gui.

Definition at line 220 of file qgssettingsentryimpl.cpp.

◆ maxValue()

double QgsSettingsEntryDouble::maxValue ( ) const

Returns the maximum value.

Definition at line 210 of file qgssettingsentryimpl.cpp.

◆ minValue()

double QgsSettingsEntryDouble::minValue ( ) const

Returns the minimum value.

Definition at line 205 of file qgssettingsentryimpl.cpp.

◆ setDisplayHintDecimals()

void QgsSettingsEntryDouble::setDisplayHintDecimals ( int  displayHintDecimals)

Set the display hint decimals.

displayHintDecimals The number of decimals that should be shown in the Gui.

Definition at line 215 of file qgssettingsentryimpl.cpp.

◆ settingsType()

Qgis::SettingsType QgsSettingsEntryDouble::settingsType ( ) const
overridevirtual

Returns the settings entry type.

Implements QgsSettingsEntryBaseTemplate< double >.

Definition at line 200 of file qgssettingsentryimpl.cpp.


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