Kodi Development  19.0
for Binary and Script based Add-Ons

Detailed Description

Inside addon main instance used helper class to give settings value.

This is used on addon::CAddonBase::SetSetting() to inform addon about settings change by used. This becomes then used to give the related value name.


The following table contains values that can be set with class CSettingValue :

Name Type Get call
Settings value as string std::string GetString
Settings value as integer int GetInt
Settings value as unsigned integer unsigned int GetUInt
Settings value as boolean bool GetBoolean
Settings value as floating point float GetFloat
Settings value as enum enum GetEnum

Here is a code example how this is used:

#include <kodi/AddonBase.h>
enum myEnumValue
{
valueA,
valueB,
valueC
};
std::string m_myStringValue;
int m_myIntegerValue;
bool m_myBooleanValue;
float m_myFloatingPointValue;
myEnumValue m_myEnumValue;
ADDON_STATUS CMyAddon::SetSetting(const std::string& settingName, const kodi::CSettingValue& settingValue)
{
if (settingName == "my_string_value")
m_myStringValue = settingValue.GetString();
else if (settingName == "my_integer_value")
m_myIntegerValue = settingValue.GetInt();
else if (settingName == "my_boolean_value")
m_myBooleanValue = settingValue.GetBoolean();
else if (settingName == "my_float_value")
m_myFloatingPointValue = settingValue.GetFloat();
else if (settingName == "my_enum_value")
m_myEnumValue = settingValue.GetEnum<myEnumValue>();
}
Note
The asked type should match the type used on settings.xml.

Modules

 Value Help
 

Function Documentation

◆ GetString()

std::string GetString ( ) const
inline

To get settings value as string.

◆ GetInt()

int GetInt ( ) const
inline

To get settings value as integer.

◆ GetUInt()

unsigned int GetUInt ( ) const
inline

To get settings value as unsigned integer.

◆ GetBoolean()

bool GetBoolean ( ) const
inline

To get settings value as boolean.

◆ GetFloat()

float GetFloat ( ) const
inline

To get settings value as floating point.

◆ GetEnum()

enumType GetEnum ( ) const
inline

To get settings value as enum.

Note
Inside settings.xml them stored as integer.
kodi::CSettingValue::GetInt
int GetInt() const
To get settings value as integer.
Definition: AddonBase.h:144
kodi::CSettingValue::GetFloat
float GetFloat() const
To get settings value as floating point.
Definition: AddonBase.h:153
kodi::CSettingValue::GetEnum
enumType GetEnum() const
To get settings value as enum.
Definition: AddonBase.h:158
kodi::CSettingValue::GetString
std::string GetString() const
To get settings value as string.
Definition: AddonBase.h:141
kodi::CSettingValue
Definition: AddonBase.h:118
kodi::CSettingValue::GetBoolean
bool GetBoolean() const
To get settings value as boolean.
Definition: AddonBase.h:150
ADDON_STATUS
ADDON_STATUS
Return value of functions in kodi::addon::CAddonBase and associated classes.
Definition: addon_base.h:80