Setting base class containing all the properties which are common to all settings independent of the setting type. More...

#include <Setting.h>

Inheritance diagram for CSetting:

Public Member Functions
	CSetting (const std::string &id, CSettingsManager *settingsManager=nullptr)

	CSetting (const std::string &id, const CSetting &setting)

	~CSetting () override=default

virtual std::shared_ptr< CSetting >	Clone (const std::string &id) const =0

void	MergeBasics (const CSetting &other)

virtual void	MergeDetails (const CSetting &other)=0

bool	Deserialize (const TiXmlNode *node, bool update=false) override
	Deserializes the given XML node into the properties of the setting object.

virtual SettingType	GetType () const =0

virtual bool	FromString (const std::string &value)=0

virtual std::string	ToString () const =0

virtual bool	Equals (const std::string &value) const =0

virtual bool	CheckValidity (const std::string &value) const =0

virtual void	Reset ()=0

bool	IsEnabled () const

bool	GetEnabled () const

void	SetEnabled (bool enabled)

bool	IsDefault () const

const std::string &	GetParent () const

void	SetParent (const std::string &parentSetting)

SettingLevel	GetLevel () const

void	SetLevel (SettingLevel level)

std::shared_ptr< const ISettingControl >	GetControl () const

std::shared_ptr< ISettingControl >	GetControl ()

void	SetControl (std::shared_ptr< ISettingControl > control)

const SettingDependencies &	GetDependencies () const

void	SetDependencies (const SettingDependencies &dependencies)

const std::set< CSettingUpdate > &	GetUpdates () const

void	SetCallback (ISettingCallback *callback)

bool	IsReference () const

const std::string &	GetReferencedId () const

void	SetReferencedId (const std::string &referencedId)

void	MakeReference (const std::string &referencedId="")

bool	GetVisible () const

bool	IsVisible () const override
	Whether the setting object is visible or hidden.

void	OnSettingAction (const std::shared_ptr< const CSetting > &setting) override
	The given setting has been activated.

Public Member Functions inherited from ISetting
	ISetting (const std::string &id, CSettingsManager *settingsManager=nullptr)
	Creates a new setting object with the given identifier.

virtual	~ISetting ()=default

const std::string &	GetId () const
	Gets the identifier of the setting object.

virtual void	SetVisible (bool visible)
	Sets the visibility state of the setting object.

int	GetLabel () const
	Gets the localizeable label ID of the setting group.

void	SetLabel (int label)
	Sets the localizeable label ID of the setting group.

int	GetHelp () const
	Gets the localizeable help ID of the setting group.

void	SetHelp (int help)
	Sets the localizeable help ID of the setting group.

virtual bool	MeetsRequirements () const
	Whether the setting object meets all necessary requirements.

virtual void	CheckRequirements ()
	Checks if the setting object meets all necessary requirements.

virtual void	SetRequirementsMet (bool requirementsMet)
	Sets whether the setting object meets all necessary requirements.

Static Public Member Functions
static bool	DeserializeIdentification (const TiXmlNode *node, std::string &identification, bool &isReference)
	Deserializes the given XML node to retrieve a setting object's identifier and whether the setting is a reference to another setting or not.

Static Public Member Functions inherited from ISetting
static bool	DeserializeIdentification (const TiXmlNode *node, std::string &identification)
	Deserializes the given XML node to retrieve a setting object's identifier.

Protected Member Functions
bool	OnSettingChanging (const std::shared_ptr< const CSetting > &setting) override
	The value of the given setting is being changed.

void	OnSettingChanged (const std::shared_ptr< const CSetting > &setting) override
	The value of the given setting has changed.

bool	OnSettingUpdate (const std::shared_ptr< CSetting > &setting, const char oldSettingId, const TiXmlNode oldSettingNode) override
	The given setting needs to be updated.

void	OnSettingPropertyChanged (const std::shared_ptr< const CSetting > &setting, const char *propertyName) override
	The given property of the given setting has changed.

void	Copy (const CSetting &setting)

template<class TSetting >
std::shared_ptr< TSetting >	shared_from_base ()

Protected Member Functions inherited from ISettingCallback
virtual	~ISettingCallback ()=default

Protected Attributes
ISettingCallback *	m_callback = nullptr

bool	m_enabled = true

std::string	m_parentSetting

SettingLevel	m_level = SettingLevel::Standard

std::shared_ptr< ISettingControl >	m_control

SettingDependencies	m_dependencies

std::set< CSettingUpdate >	m_updates

bool	m_changed = false

CSharedSection	m_critical

std::string	m_referencedId

Protected Attributes inherited from ISetting
std::string	m_id

CSettingsManager *	m_settingsManager

Additional Inherited Members
Static Protected Member Functions inherited from ISetting
static bool	DeserializeIdentificationFromAttribute (const TiXmlNode *node, const std::string &attribute, std::string &identification)
	Deserializes the given XML node to retrieve a setting object's identifier from the given attribute.

Static Protected Attributes inherited from ISetting
static constexpr int	DefaultLabel = -1

Detailed Description

Setting base class containing all the properties which are common to all settings independent of the setting type.

Constructor & Destructor Documentation

◆ CSetting() [1/2]

CSetting::CSetting	(	const std::string &	id,
		CSettingsManager *	settingsManager = nullptr )

◆ CSetting() [2/2]

CSetting::CSetting	(	const std::string &	id,
		const CSetting &	setting )

◆ ~CSetting()

CSetting::~CSetting ( )

overridedefault

Member Function Documentation

◆ CheckValidity()

virtual bool CSetting::CheckValidity ( const std::string & value ) const

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, CSettingAction, CSettingDate, and CSettingTime.

◆ Clone()

virtual std::shared_ptr< CSetting > CSetting::Clone ( const std::string & id ) const

pure virtual

Implemented in ADDON::CSettingUrlEncodedString, CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, CSettingAction, CSettingAddon, CSettingDate, CSettingTime, and CSettingPath.

◆ Copy()

void CSetting::Copy ( const CSetting & setting )

protected

◆ Deserialize()

bool CSetting::Deserialize	(	const TiXmlNode *	node,
		bool	update = false )

overridevirtual

Deserializes the given XML node into the properties of the setting object.

If the update parameter is true, the checks for mandatory properties are skipped and values are only updated.

Parameters

node	XML node containing the properties of the setting object
update	Whether to perform checks for mandatory properties or not

Returns: True if deserialization was successful, false otherwise

Reimplemented from ISetting.

Reimplemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, CSettingAction, CSettingAddon, and CSettingPath.

◆ DeserializeIdentification()

bool CSetting::DeserializeIdentification	(	const TiXmlNode *	node,
		std::string &	identification,
		bool &	isReference )

static

Deserializes the given XML node to retrieve a setting object's identifier and whether the setting is a reference to another setting or not.

Parameters

node	XML node containing a setting object's identifier
identification	Will contain the deserialized setting object's identifier
isReference	Whether the setting is a reference to the setting with the determined identifier

Returns: True if a setting object's identifier was deserialized, false otherwise

◆ Equals()

virtual bool CSetting::Equals ( const std::string & value ) const

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, and CSettingAction.

◆ FromString()

virtual bool CSetting::FromString ( const std::string & value )

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, and CSettingAction.

◆ GetControl() [1/2]

std::shared_ptr< ISettingControl > CSetting::GetControl ( )

inline

◆ GetControl() [2/2]

std::shared_ptr< const ISettingControl > CSetting::GetControl ( ) const

inline

◆ GetDependencies()

const SettingDependencies & CSetting::GetDependencies ( ) const

inline

◆ GetEnabled()

bool CSetting::GetEnabled ( ) const

inline

◆ GetLevel()

SettingLevel CSetting::GetLevel ( ) const

inline

◆ GetParent()

const std::string & CSetting::GetParent ( ) const

inline

◆ GetReferencedId()

const std::string & CSetting::GetReferencedId ( ) const

inline

◆ GetType()

virtual SettingType CSetting::GetType ( ) const

pure virtual

Implemented in CTraitedSetting< TValue, TSettingType >, CTraitedSetting< bool, SettingType::Boolean >, CTraitedSetting< double, SettingType::Number >, CTraitedSetting< int, SettingType::Integer >, CTraitedSetting< std::string, SettingType::String >, CSettingList, and CSettingAction.

◆ GetUpdates()

const std::set< CSettingUpdate > & CSetting::GetUpdates ( ) const

inline

◆ GetVisible()

bool CSetting::GetVisible ( ) const

inline

◆ IsDefault()

bool CSetting::IsDefault ( ) const

inline

◆ IsEnabled()

bool CSetting::IsEnabled ( ) const

◆ IsReference()

bool CSetting::IsReference ( ) const

inline

◆ IsVisible()

bool CSetting::IsVisible ( ) const

overridevirtual

Whether the setting object is visible or hidden.

Returns: True if the setting object is visible, false otherwise

Reimplemented from ISetting.

◆ MakeReference()

void CSetting::MakeReference ( const std::string & referencedId = "" )

◆ MergeBasics()

void CSetting::MergeBasics ( const CSetting & other )

◆ MergeDetails()

virtual void CSetting::MergeDetails ( const CSetting & other )

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, and CSettingAction.

◆ OnSettingAction()

void CSetting::OnSettingAction ( const std::shared_ptr< const CSetting > & setting )

overridevirtual

The given setting has been activated.

This callback is triggered whenever the given setting has been activated. This callback is only fired for CSettingAction settings.

Parameters

setting The setting which has been activated.

Reimplemented from ISettingCallback.

◆ OnSettingChanged()

void CSetting::OnSettingChanged ( const std::shared_ptr< const CSetting > & setting )

overrideprotectedvirtual

The value of the given setting has changed.

This callback is triggered whenever the value of a setting has been successfully changed (i.e. none of the OnSettingChanging() handlers) has reverted the change.

Parameters

setting The setting whose value has been changed

Reimplemented from ISettingCallback.

◆ OnSettingChanging()

bool CSetting::OnSettingChanging ( const std::shared_ptr< const CSetting > & setting )

overrideprotectedvirtual

The value of the given setting is being changed.

This callback is triggered whenever the value of a setting is being changed. The given CSetting already contains the new value and the handler of the callback has the possibility to allow or revert changing the value of the setting. In case of a revert OnSettingChanging() is called again to inform all listeners that the value change has been reverted.

Parameters

setting The setting whose value is being changed (already containing the changed value)

Returns: True if the new value is acceptable otherwise false

Reimplemented from ISettingCallback.

◆ OnSettingPropertyChanged()

void CSetting::OnSettingPropertyChanged	(	const std::shared_ptr< const CSetting > &	setting,
		const char *	propertyName )

overrideprotectedvirtual

The given property of the given setting has changed.

This callback is triggered when a property (e.g. enabled or the list of dynamic options) has changed.

Parameters

setting	The setting which has a changed property
propertyName	The string representation of the changed property

Reimplemented from ISettingCallback.

◆ OnSettingUpdate()

bool CSetting::OnSettingUpdate	(	const std::shared_ptr< CSetting > &	setting,
		const char *	oldSettingId,
		const TiXmlNode *	oldSettingNode )

overrideprotectedvirtual

The given setting needs to be updated.

This callback is triggered when a setting needs to be updated because its value is outdated. This only happens when initially loading the value of a setting and will not be triggered afterwards.

Parameters

setting	The setting which needs to be updated.
oldSettingId	The id of the previous setting.
oldSettingNode	The old setting node

Returns: True if the setting has been successfully updated otherwise false

Reimplemented from ISettingCallback.

◆ Reset()

virtual void CSetting::Reset ( )

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, and CSettingAction.

◆ SetCallback()

void CSetting::SetCallback ( ISettingCallback * callback )

inline

◆ SetControl()

void CSetting::SetControl ( std::shared_ptr< ISettingControl > control )

inline

◆ SetDependencies()

void CSetting::SetDependencies ( const SettingDependencies & dependencies )

inline

◆ SetEnabled()

void CSetting::SetEnabled ( bool enabled )

◆ SetLevel()

void CSetting::SetLevel ( SettingLevel level )

inline

◆ SetParent()

void CSetting::SetParent ( const std::string & parentSetting )

inline

◆ SetReferencedId()

void CSetting::SetReferencedId ( const std::string & referencedId )

inline

◆ shared_from_base()

template<class TSetting >

std::shared_ptr< TSetting > CSetting::shared_from_base ( )

inlineprotected

◆ ToString()

virtual std::string CSetting::ToString ( ) const

pure virtual

Implemented in CSettingList, CSettingBool, CSettingInt, CSettingNumber, CSettingString, and CSettingAction.

Member Data Documentation

◆ m_callback

ISettingCallback* CSetting::m_callback = nullptr

protected

◆ m_changed

bool CSetting::m_changed = false

protected

◆ m_control

std::shared_ptr<ISettingControl> CSetting::m_control

protected

◆ m_critical

CSharedSection CSetting::m_critical

mutableprotected

◆ m_dependencies

SettingDependencies CSetting::m_dependencies

protected

◆ m_enabled

bool CSetting::m_enabled = true

protected

◆ m_level

SettingLevel CSetting::m_level = SettingLevel::Standard

protected

◆ m_parentSetting

std::string CSetting::m_parentSetting

protected

◆ m_referencedId

std::string CSetting::m_referencedId

protected

◆ m_updates

std::set<CSettingUpdate> CSetting::m_updates

protected

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CSetting() [1/2]

◆ CSetting() [2/2]

◆ ~CSetting()

Member Function Documentation

◆ CheckValidity()

◆ Clone()

◆ Copy()

◆ Deserialize()

◆ DeserializeIdentification()

◆ Equals()

◆ FromString()

◆ GetControl() [1/2]

◆ GetControl() [2/2]

◆ GetDependencies()

◆ GetEnabled()

◆ GetLevel()

◆ GetParent()

◆ GetReferencedId()

◆ GetType()

◆ GetUpdates()

◆ GetVisible()

◆ IsDefault()

◆ IsEnabled()

◆ IsReference()

◆ IsVisible()

◆ MakeReference()

◆ MergeBasics()

◆ MergeDetails()

◆ OnSettingAction()

◆ OnSettingChanged()

◆ OnSettingChanging()

◆ OnSettingPropertyChanged()

◆ OnSettingUpdate()

◆ Reset()

◆ SetCallback()

◆ SetControl()

◆ SetDependencies()

◆ SetEnabled()

◆ SetLevel()

◆ SetParent()

◆ SetReferencedId()

◆ shared_from_base()

◆ ToString()

Member Data Documentation

◆ m_callback

◆ m_changed

◆ m_control

◆ m_critical

◆ m_dependencies

◆ m_enabled

◆ m_level

◆ m_parentSetting

◆ m_referencedId

◆ m_updates