Kodi Documentation 18.0
Kodi is an open source media player and entertainment hub.
CSettingAction Class Reference

Action setting implementation. More...

#include <Setting.h>

Inheritance diagram for CSettingAction:
CSetting ISetting ISettingCallback

Public Member Functions

 CSettingAction (const std::string &id, CSettingsManager *settingsManager=nullptr)
 
 CSettingAction (const std::string &id, int label, CSettingsManager *settingsManager=nullptr)
 
 CSettingAction (const std::string &id, const CSettingAction &setting)
 
 ~CSettingAction () override=default
 
std::shared_ptr< CSettingClone (const std::string &id) const override
 
bool Deserialize (const TiXmlNode *node, bool update=false) override
 Deserializes the given XML node into the properties of the setting object. More...
 
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
 
bool HasData () const
 
const std::string & GetData () const
 
void SetData (const std::string &data)
 
- 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
 
bool IsEnabled () 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 ISettingControlGetControl () const
 
std::shared_ptr< ISettingControlGetControl ()
 
void SetControl (std::shared_ptr< ISettingControl > control)
 
const SettingDependenciesGetDependencies () const
 
void SetDependencies (const SettingDependencies &dependencies)
 
const std::set< CSettingUpdate > & GetUpdates () const
 
void SetCallback (ISettingCallback *callback)
 
bool IsVisible () const override
 Whether the setting object is visible or hidden. More...
 
void OnSettingAction (std::shared_ptr< const CSetting > setting) override
 The given setting has been activated. More...
 
- Public Member Functions inherited from ISetting
 ISetting (const std::string &id, CSettingsManager *settingsManager=nullptr)
 Creates a new setting object with the given identifier. More...
 
virtual ~ISetting ()=default
 
const std::string & GetId () const
 Gets the identifier of the setting object. More...
 
virtual void SetVisible (bool visible)
 Sets the visibility state of the setting object. More...
 
int GetLabel () const
 Gets the localizeable label ID of the setting group. More...
 
void SetLabel (int label)
 Sets the localizeable label ID of the setting group. More...
 
int GetHelp () const
 Gets the localizeable help ID of the setting group. More...
 
void SetHelp (int help)
 Sets the localizeable help ID of the setting group. More...
 
virtual bool MeetsRequirements () const
 Whether the setting object meets all necessary requirements. More...
 
virtual void CheckRequirements ()
 Checks if the setting object meets all necessary requirements. More...
 
virtual void SetRequirementsMet (bool requirementsMet)
 Sets whether the setting object meets all necessary requirements. More...
 

Protected Attributes

std::string m_data
 
- Protected Attributes inherited from CSetting
ISettingCallbackm_callback = nullptr
 
bool m_enabled = true
 
std::string m_parentSetting
 
SettingLevel m_level = SettingLevel::Standard
 
std::shared_ptr< ISettingControlm_control
 
SettingDependencies m_dependencies
 
std::set< CSettingUpdatem_updates
 
bool m_changed = false
 
CSharedSection m_critical
 
- Protected Attributes inherited from ISetting
std::string m_id
 
CSettingsManagerm_settingsManager
 

Additional Inherited Members

- 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. More...
 
- Protected Member Functions inherited from CSetting
bool OnSettingChanging (std::shared_ptr< const CSetting > setting) override
 The value of the given setting is being changed. More...
 
void OnSettingChanged (std::shared_ptr< const CSetting > setting) override
 The value of the given setting has changed. More...
 
bool OnSettingUpdate (std::shared_ptr< CSetting > setting, const char *oldSettingId, const TiXmlNode *oldSettingNode) override
 The given setting needs to be updated. More...
 
void OnSettingPropertyChanged (std::shared_ptr< const CSetting > setting, const char *propertyName) override
 The given property of the given setting has changed. More...
 
void Copy (const CSetting &setting)
 
template<class TSetting >
std::shared_ptr< TSetting > shared_from_base ()
 
- Protected Member Functions inherited from ISettingCallback
virtual ~ISettingCallback ()=default
 

Detailed Description

Action setting implementation.

A setting action will trigger a call to the OnSettingAction() callback method when activated.

See also
CSetting

Constructor & Destructor Documentation

◆ CSettingAction() [1/3]

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

◆ CSettingAction() [2/3]

CSettingAction::CSettingAction ( const std::string &  id,
int  label,
CSettingsManager settingsManager = nullptr 
)

◆ CSettingAction() [3/3]

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

◆ ~CSettingAction()

CSettingAction::~CSettingAction ( )
overridedefault

Member Function Documentation

◆ CheckValidity()

bool CSettingAction::CheckValidity ( const std::string &  value) const
inlineoverridevirtual

Implements CSetting.

◆ Clone()

SettingPtr CSettingAction::Clone ( const std::string &  id) const
overridevirtual

Implements CSetting.

◆ Deserialize()

bool CSettingAction::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
nodeXML node containing the properties of the setting object
updateWhether to perform checks for mandatory properties or not
Returns
True if deserialization was successful, false otherwise

Reimplemented from CSetting.

◆ Equals()

bool CSettingAction::Equals ( const std::string &  value) const
inlineoverridevirtual

Implements CSetting.

◆ FromString()

bool CSettingAction::FromString ( const std::string &  value)
inlineoverridevirtual

Implements CSetting.

◆ GetData()

const std::string & CSettingAction::GetData ( ) const
inline

◆ GetType()

SettingType CSettingAction::GetType ( ) const
inlineoverridevirtual

Implements CSetting.

◆ HasData()

bool CSettingAction::HasData ( ) const
inline

◆ Reset()

void CSettingAction::Reset ( void  )
inlineoverridevirtual

Implements CSetting.

◆ SetData()

void CSettingAction::SetData ( const std::string &  data)
inline

◆ ToString()

std::string CSettingAction::ToString ( ) const
inlineoverridevirtual

Implements CSetting.

Member Data Documentation

◆ m_data

std::string CSettingAction::m_data
protected

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