Class: QgsSettingsEntryByReferenceQStringListBase

class qgis.core.QgsSettingsEntryByReferenceQStringListBase

Bases: QgsSettingsEntryBase

Base abstract class for settings entry which are passed by reference

See also

QgsSettingsEntryByValue

New in version 3.26.

QgsSettingsEntryByReferenceQStringListBase(key: str, section: str, defaultValue: Iterable[str], description: str = ‘’, options: Union[Qgis.SettingsOptions, Qgis.SettingsOption] = Qgis.SettingsOptions()) Constructor for QgsSettingsEntryByReference.

The key argument specifies the key of the settings. The defaultValue argument specifies the default value for the settings entry. The description argument specifies a description for the settings entry. The options arguments specifies the options for the settings entry.

QgsSettingsEntryByReferenceQStringListBase(QgsSettingsEntryByReferenceQStringListBase)

Methods

checkValue

Check if the value is valid

convertFromVariant

Converts the variant value to the value type of the setting

convertToVariant

Converts the value to a variant

defaultValue

Returns settings default value.

formerValue

Returns the former value.

setValue

Set settings value.

setValuePrivate

Sets the settings value with an optional list of dynamic parts

setVariantValuePrivate

Sets the settings value with a variant value.

settingsType

rtype:

Qgis.SettingsType

value

Returns settings value.

valueWithDefaultOverride

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

checkValue(self, value: Iterable[str]) bool

Check if the value is valid

Parameters:

value (Iterable[str]) –

Return type:

bool

convertFromVariant(self, value: Any) List[str]

Converts the variant value to the value type of the setting

Parameters:

value (Any) –

Return type:

List[str]

convertToVariant(self, value: Iterable[str]) Any

Converts the value to a variant

Parameters:

value (Iterable[str]) –

Return type:

Any

defaultValue(self) List[str]

Returns settings default value.

Return type:

List[str]

formerValue(self, dynamicKeyPart: str = '') List[str]

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

formerValue(self, dynamicKeyPartList: Iterable[str]) -> List[str] Returns the former value Returns the current value (or default) if there is no former value.

Parameters:

dynamicKeyPart (str = '') –

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

setValuePrivate(self, value: Iterable[str], dynamicKeyPartList: Iterable[str]) bool

Sets the settings value with an optional list of dynamic parts

Parameters:
  • value (Iterable[str]) –

  • dynamicKeyPartList (Iterable[str]) –

Return type:

bool

setVariantValuePrivate(self, value: Any, dynamicKeyPartList: Iterable[str] = []) bool

Sets the settings value with a variant value. This should be called from any implementation as it takes care of actually calling QSettings

New in version 3.26.

settingsType(self) Qgis.SettingsType
Return type:

Qgis.SettingsType

value(self, dynamicKeyPart: str = '') List[str]

Returns settings value.

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

value(self, dynamicKeyPartList: Iterable[str]) -> List[str] Returns settings value.

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

value(self, dynamicKeyPart: str, useDefaultValueOverride: bool, defaultValueOverride: Iterable[str]) -> List[str] Returns the settings value for the dynamicKeyPart and with a defaultValueOverride

Deprecated since version QGIS: 3.26 use valueAsVariantWithDefaultOverride instead

value(self, dynamicKeyPartList: Iterable[str], useDefaultValueOverride: bool, defaultValueOverride: Iterable[str]) -> List[str] Returns the settings value for the dynamicKeyPartList and with a defaultValueOverride

Deprecated since version QGIS: 3.26 use valueAsVariantWithDefaultOverride instead

Parameters:

dynamicKeyPart (str = '') –

Return type:

List[str]

valueWithDefaultOverride(self, defaultValueOverride: Iterable[str], dynamicKeyPart: str = '') List[str]

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

valueWithDefaultOverride(self, defaultValueOverride: Iterable[str], dynamicKeyPartList: Iterable[str]) -> List[str] Returns the settings value with a defaultValueOverride for the dynamicKeyPartList

Parameters:
  • defaultValueOverride (Iterable[str]) –

  • dynamicKeyPart (str = '') –

Return type:

List[str]