Class: QgsSettingsEntryStringList

class qgis.core.QgsSettingsEntryStringList

Bases: QgsSettingsEntryBase

A string list settings entry.

New in version 3.20.

QgsSettingsEntryStringList(key: str, pluginName: str, defaultValue: Iterable[str] = [], description: str = ‘’) Constructor for QgsSettingsEntryStringList. This constructor is intended to be used from plugins.

The key argument specifies the key of the settings. The pluginName argument is inserted in the key after the section. The default value argument specifies the default value for the settings entry. The description argument specifies a description for the settings entry.

QgsSettingsEntryStringList(QgsSettingsEntryStringList)

Methods

defaultValue

Get settings default value.

setValue

Set settings value.

settingsType

copydoc QgsSettingsEntryBase.settingsType

value

Get settings value.

defaultValue(self) List[str]

Get settings default value.

Return type

List[str]

setValue(self, value: Iterable[str], dynamicKeyPart: str = '') bool

Set settings value.

The value to set. The dynamicKeyPart argument specifies the dynamic part of the settings key.

setValue(self, value: Iterable[str], dynamicKeyPartList: Iterable[str]) -> bool Set settings value.

The value to set. The dynamicKeyParts argument specifies the list of dynamic parts of the settings key.

Parameters
  • value (Iterable[str]) –

  • dynamicKeyPart (str = '') –

Return type

bool

settingsType(self) QgsSettingsEntryBase.SettingsType

copydoc QgsSettingsEntryBase.settingsType

Return type

QgsSettingsEntryBase.SettingsType

value(self, dynamicKeyPart: str = '', useDefaultValueOverride: bool = False, defaultValueOverride: Iterable[str] = []) List[str]

Get settings value.

The dynamicKeyPart argument specifies the dynamic part of the settings key. The useDefaultValueOverride argument specifies if defaultValueOverride should be used. The defaultValueOverride argument if valid is used instead of the normal default value.

value(self, dynamicKeyPartList: Iterable[str], useDefaultValueOverride: bool = False, defaultValueOverride: Iterable[str] = []) -> List[str] Get settings value.

The dynamicKeyParts argument specifies the list of dynamic parts of the settings key. The useDefaultValueOverride argument specifies if defaultValueOverride should be used. The defaultValueOverride argument if valid is used instead of the normal default value.

Parameters
  • dynamicKeyPart (str = '') –

  • useDefaultValueOverride (bool = False) –

  • defaultValueOverride (Iterable[str] = []) –

Return type

List[str]