#ifndef SCIQLOP_DATASOURCEITEM_H #define SCIQLOP_DATASOURCEITEM_H #include "CoreGlobal.h" #include #include #include class DataSourceItemAction; /** * Possible types of an item */ enum class DataSourceItemType { NODE, PRODUCT, COMPONENT }; /** * @brief The DataSourceItem class aims to represent a structure element of a data source. * A data source has a tree structure that is made up of a main DataSourceItem object (root) * containing other DataSourceItem objects (children). * For each DataSourceItem can be associated a set of data representing it. */ class SCIQLOP_CORE_EXPORT DataSourceItem { public: /// Key associated with the name of the item static const QString NAME_DATA_KEY; explicit DataSourceItem(DataSourceItemType type, const QString &name); explicit DataSourceItem(DataSourceItemType type, QVariantHash data = {}); /// @return the actions of the item as a vector QVector actions() const noexcept; /** * Adds an action to the item. The item takes ownership of the action, and the action is * automatically associated to the item * @param action the action to add */ void addAction(std::unique_ptr action) noexcept; /** * Adds a child to the item. The item takes ownership of the child. * @param child the child to add */ void appendChild(std::unique_ptr child) noexcept; /** * Returns the item's child associated to an index * @param childIndex the index to search * @return a pointer to the child if index is valid, nullptr otherwise */ DataSourceItem *child(int childIndex) const noexcept; int childCount() const noexcept; /** * Get the data associated to a key * @param key the key to search * @return the data found if key is valid, default QVariant otherwise */ QVariant data(const QString &key) const noexcept; /// Gets all data QVariantHash data() const noexcept; bool isRoot() const noexcept; QString name() const noexcept; /** * Get the item's parent * @return a pointer to the parent if it exists, nullptr if the item is a root */ DataSourceItem *parentItem() const noexcept; /** * Gets the item's root * @return the top parent, the item itself if it's the root item */ const DataSourceItem &rootItem() const noexcept; /** * Sets or appends a value to a key * @param key the key * @param value the value * @param append if true, the value is added to the values already existing for the key, * otherwise it replaces the existing values */ void setData(const QString &key, const QVariant &value, bool append = false) noexcept; DataSourceItemType type() const noexcept; bool operator==(const DataSourceItem &other); bool operator!=(const DataSourceItem &other); private: class DataSourceItemPrivate; spimpl::unique_impl_ptr impl; }; #endif // SCIQLOP_DATASOURCEITEMMODEL_H