From c04dcc2e7d834218ef2d4194331e383402495ae1 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 10 Apr 2024 20:07:22 +0200 Subject: Adding upstream version 2:20.4+dfsg. Signed-off-by: Daniel Baumann --- xbmc/settings/lib/SettingSection.h | 186 +++++++++++++++++++++++++++++++++++++ 1 file changed, 186 insertions(+) create mode 100644 xbmc/settings/lib/SettingSection.h (limited to 'xbmc/settings/lib/SettingSection.h') diff --git a/xbmc/settings/lib/SettingSection.h b/xbmc/settings/lib/SettingSection.h new file mode 100644 index 0000000..f8e06d6 --- /dev/null +++ b/xbmc/settings/lib/SettingSection.h @@ -0,0 +1,186 @@ +/* + * Copyright (C) 2013-2018 Team Kodi + * This file is part of Kodi - https://kodi.tv + * + * SPDX-License-Identifier: GPL-2.0-or-later + * See LICENSES/README.md for more information. + */ + +#pragma once + +#include "ISetting.h" +#include "Setting.h" +#include "SettingCategoryAccess.h" +#include "utils/logtypes.h" + +#include +#include +#include + +class CSettingsManager; + +/*! + \ingroup settings + \brief Group of settings being part of a category + \sa CSettingCategory + \sa CSetting + */ +class CSettingGroup : public ISetting +{ +public: + /*! + \brief Creates a new setting group with the given identifier. + + \param id Identifier of the setting group + \param settingsManager Reference to the settings manager + */ + CSettingGroup(const std::string &id, CSettingsManager *settingsManager = nullptr); + ~CSettingGroup() override = default; + + // implementation of ISetting + bool Deserialize(const TiXmlNode *node, bool update = false) override; + + /*! + \brief Gets the full list of settings belonging to the setting group. + + \return Full list of settings belonging to the setting group + */ + const SettingList& GetSettings() const { return m_settings; } + /*! + \brief Gets the list of settings assigned to the given setting level (or + below) and that meet the requirements conditions belonging to the setting + group. + + \param level Level the settings should be assigned to + \return List of settings belonging to the setting group + */ + SettingList GetSettings(SettingLevel level) const; + + void AddSetting(const std::shared_ptr& setting); + void AddSettings(const SettingList &settings); + + bool ReplaceSetting(const std::shared_ptr& currentSetting, + const std::shared_ptr& newSetting); + + std::shared_ptr GetControl() const { return m_control; } + std::shared_ptr GetControl() { return m_control; } + void SetControl(std::shared_ptr control) { m_control = std::move(control); } + +private: + SettingList m_settings; + std::shared_ptr m_control; + + static Logger s_logger; +}; + +using SettingGroupPtr = std::shared_ptr; +using SettingGroupList = std::vector; + +/*! + \ingroup settings + \brief Category of groups of settings being part of a section + \sa CSettingSection + \sa CSettingGroup + */ +class CSettingCategory : public ISetting +{ +public: + /*! + \brief Creates a new setting category with the given identifier. + + \param id Identifier of the setting category + \param settingsManager Reference to the settings manager + */ + CSettingCategory(const std::string &id, CSettingsManager *settingsManager = nullptr); + ~CSettingCategory() override = default; + + // implementation of ISetting + bool Deserialize(const TiXmlNode *node, bool update = false) override; + + /*! + \brief Gets the full list of setting groups belonging to the setting + category. + + \return Full list of setting groups belonging to the setting category + */ + const SettingGroupList& GetGroups() const { return m_groups; } + /*! + \brief Gets the list of setting groups belonging to the setting category + that contain settings assigned to the given setting level (or below) and + that meet the requirements and visibility conditions. + + \param level Level the settings should be assigned to + \return List of setting groups belonging to the setting category + */ + SettingGroupList GetGroups(SettingLevel level) const; + + /*! + \brief Whether the setting category can be accessed or not. + + \return True if the setting category can be accessed, false otherwise + */ + bool CanAccess() const; + + void AddGroup(const SettingGroupPtr& group); + void AddGroupToFront(const SettingGroupPtr& group); + void AddGroups(const SettingGroupList &groups); + +private: + SettingGroupList m_groups; + CSettingCategoryAccess m_accessCondition; + + static Logger s_logger; +}; + +using SettingCategoryPtr = std::shared_ptr; +using SettingCategoryList = std::vector; + +/*! + \ingroup settings + \brief Section of setting categories + \sa CSettings + \sa CSettingCategory + */ +class CSettingSection : public ISetting +{ +public: + /*! + \brief Creates a new setting section with the given identifier. + + \param id Identifier of the setting section + \param settingsManager Reference to the settings manager + */ + CSettingSection(const std::string &id, CSettingsManager *settingsManager = nullptr); + ~CSettingSection() override = default; + + // implementation of ISetting + bool Deserialize(const TiXmlNode *node, bool update = false) override; + + /*! + \brief Gets the full list of setting categories belonging to the setting + section. + + \return Full list of setting categories belonging to the setting section + */ + const SettingCategoryList& GetCategories() const { return m_categories; } + /*! + \brief Gets the list of setting categories belonging to the setting section + that contain settings assigned to the given setting level (or below) and + that meet the requirements and visibility conditions. + + \param level Level the settings should be assigned to + \return List of setting categories belonging to the setting section + */ + SettingCategoryList GetCategories(SettingLevel level) const; + + void AddCategory(const SettingCategoryPtr& category); + void AddCategories(const SettingCategoryList &categories); + +private: + SettingCategoryList m_categories; + + static Logger s_logger; +}; + +using SettingSectionPtr = std::shared_ptr; +using SettingSectionList = std::vector; -- cgit v1.2.3