CSettingList Class Reference

List setting implementation. More...

#include <Setting.h>

Inheritance diagram for CSettingList:

Public Member Functions
	CSettingList (const std::string &id, std::shared_ptr< CSetting > settingDefinition, CSettingsManager *settingsManager=nullptr)
	CSettingList (const std::string &id, std::shared_ptr< CSetting > settingDefinition, int label, CSettingsManager *settingsManager=nullptr)
	CSettingList (const std::string &id, const CSettingList &setting)
	~CSettingList () override=default
std::shared_ptr< CSetting >	Clone (const std::string &id) const override
void	MergeDetails (const CSetting &other) override
bool	Deserialize (const TiXmlNode *node, bool update=false) override
	Deserializes the given XML node into the properties of the setting object.
SettingType	GetType () const override
bool	FromString (const std::string &value) override
std::string	ToString () const override
bool	Equals (const std::string &value) const override
bool	CheckValidity (const std::string &value) const override
void	Reset () override
SettingType	GetElementType () const
std::shared_ptr< CSetting >	GetDefinition ()
std::shared_ptr< const CSetting >	GetDefinition () const
void	SetDefinition (std::shared_ptr< CSetting > definition)
const std::string &	GetDelimiter () const
void	SetDelimiter (const std::string &delimiter)
int	GetMinimumItems () const
void	SetMinimumItems (int minimumItems)
int	GetMaximumItems () const
void	SetMaximumItems (int maximumItems)
bool	FromString (const std::vector< std::string > &value)
const SettingList &	GetValue () const
bool	SetValue (const SettingList &values)
const SettingList &	GetDefault () const
void	SetDefault (const SettingList &values)
Public Member Functions inherited from CSetting
	CSetting (const std::string &id, CSettingsManager *settingsManager=nullptr)
	CSetting (const std::string &id, const CSetting &setting)
	~CSetting () override=default
void	MergeBasics (const CSetting &other)
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.

Protected Member Functions
void	copy (const CSettingList &setting)
bool	fromString (const std::string &strValue, SettingList &values) const
bool	fromValues (const std::vector< std::string > &strValues, SettingList &values) const
std::string	toString (const SettingList &values) const
Protected Member Functions inherited from CSetting
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

Static Protected Member Functions
static void	copy (const SettingList &srcValues, SettingList &dstValues)
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.

Protected Attributes
SettingList	m_values
SettingList	m_defaults
std::shared_ptr< CSetting >	m_definition
std::string	m_delimiter = "|"
int	m_minimumItems = 0
int	m_maximumItems = -1
Protected Attributes inherited from CSetting
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

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

Additional Inherited Members
Static Public Member Functions inherited from CSetting
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.

Detailed Description

List setting implementation.

See also

CSetting

Constructor & Destructor Documentation

CSettingList() [1/3]

CSettingList::CSettingList	(	const std::string &	id,
		std::shared_ptr< CSetting >	settingDefinition,
		CSettingsManager *	settingsManager = nullptr )

CSettingList() [2/3]

CSettingList::CSettingList	(	const std::string &	id,
		std::shared_ptr< CSetting >	settingDefinition,
		int	label,
		CSettingsManager *	settingsManager = nullptr )

CSettingList() [3/3]

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

~CSettingList()

CSettingList::~CSettingList ( )

overridedefault

Member Function Documentation

CheckValidity()

bool CSettingList::CheckValidity ( const std::string & value ) const

overridevirtual

Implements CSetting.

Clone()

SettingPtr CSettingList::Clone ( const std::string & id ) const

overridevirtual

Implements CSetting.

copy() [1/2]

void CSettingList::copy ( const CSettingList & setting )

protected

copy() [2/2]

void CSettingList::copy ( const SettingList & srcValues, SettingList & dstValues )

staticprotected

Deserialize()

bool CSettingList::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 CSetting.

Equals()

bool CSettingList::Equals ( const std::string & value ) const

overridevirtual

Implements CSetting.

fromString()

bool CSettingList::fromString ( const std::string & strValue, SettingList & values ) const

protected

FromString() [1/2]

bool CSettingList::FromString ( const std::string & value )

overridevirtual

Implements CSetting.

FromString() [2/2]

bool CSettingList::FromString

(

const std::vector< std::string > &

value

)

fromValues()

bool CSettingList::fromValues ( const std::vector< std::string > & strValues, SettingList & values ) const

protected

GetDefault()

const SettingList & CSettingList::GetDefault ( ) const

inline

GetDefinition() [1/2]

std::shared_ptr< CSetting > CSettingList::GetDefinition ( )

inline

GetDefinition() [2/2]

std::shared_ptr< const CSetting > CSettingList::GetDefinition ( ) const

inline

GetDelimiter()

const std::string & CSettingList::GetDelimiter ( ) const

inline

GetElementType()

SettingType CSettingList::GetElementType

(

)

const

GetMaximumItems()

int CSettingList::GetMaximumItems ( ) const

inline

GetMinimumItems()

int CSettingList::GetMinimumItems ( ) const

inline

GetType()

SettingType CSettingList::GetType ( ) const

inlineoverridevirtual

Implements CSetting.

GetValue()

const SettingList & CSettingList::GetValue ( ) const

inline

MergeDetails()

void CSettingList::MergeDetails ( const CSetting & other )

overridevirtual

Implements CSetting.

Reset()

void CSettingList::Reset ( )

overridevirtual

Implements CSetting.

SetDefault()

void CSettingList::SetDefault

(

const SettingList &

values

)

SetDefinition()

void CSettingList::SetDefinition ( std::shared_ptr< CSetting > definition )

inline

SetDelimiter()

void CSettingList::SetDelimiter ( const std::string & delimiter )

inline

SetMaximumItems()

void CSettingList::SetMaximumItems ( int maximumItems )

inline

SetMinimumItems()

void CSettingList::SetMinimumItems ( int minimumItems )

inline

SetValue()

bool CSettingList::SetValue

(

const SettingList &

values

)

ToString()

std::string CSettingList::ToString ( ) const

overridevirtual

Implements CSetting.

toString()

std::string CSettingList::toString ( const SettingList & values ) const

protected

Member Data Documentation

m_defaults

SettingList CSettingList::m_defaults

protected

m_definition

std::shared_ptr<CSetting> CSettingList::m_definition

protected

m_delimiter

std::string CSettingList::m_delimiter = "|"

protected

m_maximumItems

int CSettingList::m_maximumItems = -1

protected

m_minimumItems

int CSettingList::m_minimumItems = 0

protected

m_values

SettingList CSettingList::m_values

protected

s_logger

Logger CSettingList::s_logger

staticprotected

---

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

• Setting.h
• Setting.cpp