kpluginmodel.h

/*
    SPDX-FileCopyrightText: 2021 Nicolas Fella <[email protected]>
    SPDX-FileCopyrightText: 2021 Alexander Lohnau <[email protected]>
 
    SPDX-License-Identifier: LGPL-2.0-or-later
*/
 
#ifndef KPLUGINMODEL_H
#define KPLUGINMODEL_H
 
#include "kcmutilscore_export.h"
 
#include <QAbstractListModel>
#include <QVector>
 
#include <KPluginMetaData>
#include <memory>
 
class KConfigGroup;
class KPluginModelPrivate;
 
class KCMUTILSCORE_EXPORT KPluginModel : public QAbstractListModel
{
    Q_OBJECT
 
public:
    enum Roles {
        NameRole = Qt::DisplayRole,
        IconRole = Qt::DecorationRole,
        EnabledRole = Qt::CheckStateRole,
        DescriptionRole = Qt::UserRole + 1,
        IsChangeableRole,
        MetaDataRole,
        ConfigRole,
        IdRole,
        EnabledByDefaultRole,
    };
 
    explicit KPluginModel(QObject *parent = nullptr);
    ~KPluginModel() override;
 
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override;
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    QHash<int, QByteArray> roleNames() const override;
 
    void addPlugins(const QVector<KPluginMetaData> &plugins, const QString &categoryLabel);
    void clear();
    void setConfig(const KConfigGroup &config);
    void save();
    void load();
    void defaults();
    bool isSaveNeeded();
 
    /**
     * Returns the KPluginMetaData object of the plugin's config module. If no plugin is found or the plugin does not have a config, the resulting
     * KPluginMetaData object will be invalid.
     * @since 5.94
     */
    KPluginMetaData findConfigForPluginId(const QString &pluginId) const;
 
    Q_SIGNAL void defaulted(bool isDefaulted);
    Q_SIGNAL void isSaveNeededChanged();
 
private:
    const std::unique_ptr<KPluginModelPrivate> d;
};
#endif