59ea88f1ad
The single-values *package* member in a PackageItem was not used, so remove it -- to show that it really isn't used. This is prep- work for putting the package name *back*, as multi-valued, and using the *packages* module.
117 lines
3.3 KiB
C++
117 lines
3.3 KiB
C++
/* === This file is part of Calamares - <https://calamares.io> ===
|
|
*
|
|
* SPDX-FileCopyrightText: 2019 Adriaan de Groot <groot@kde.org>
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
|
*
|
|
* Calamares is Free Software: see the License-Identifier above.
|
|
*
|
|
*/
|
|
|
|
#ifndef PACKAGEMODEL_H
|
|
#define PACKAGEMODEL_H
|
|
|
|
#include "locale/TranslatableConfiguration.h"
|
|
#include "utils/NamedEnum.h"
|
|
|
|
#include <QAbstractListModel>
|
|
#include <QObject>
|
|
#include <QPixmap>
|
|
#include <QVector>
|
|
|
|
enum class PackageChooserMode
|
|
{
|
|
Optional, // zero or one
|
|
Required, // exactly one
|
|
OptionalMultiple, // zero or more
|
|
RequiredMultiple // one or more
|
|
};
|
|
|
|
const NamedEnumTable< PackageChooserMode >& roleNames();
|
|
|
|
struct PackageItem
|
|
{
|
|
QString id;
|
|
CalamaresUtils::Locale::TranslatedString name;
|
|
CalamaresUtils::Locale::TranslatedString description;
|
|
QPixmap screenshot;
|
|
|
|
/// @brief Create blank PackageItem
|
|
PackageItem();
|
|
/** @brief Creates a PackageItem from given strings
|
|
*
|
|
* This constructor sets all the text members,
|
|
* but leaves the screenshot blank. Set that separately.
|
|
*/
|
|
PackageItem( const QString& id, const QString& name, const QString& description );
|
|
|
|
/** @brief Creates a PackageItem from given strings.
|
|
*
|
|
* Set all the text members and load the screenshot from the given
|
|
* @p screenshotPath, which may be a QRC path (:/path/in/qrc) or
|
|
* a filesystem path, whatever QPixmap understands.
|
|
*/
|
|
PackageItem( const QString& id,
|
|
const QString& name,
|
|
const QString& description,
|
|
const QString& screenshotPath );
|
|
|
|
/** @brief Creates a PackageItem from a QVariantMap
|
|
*
|
|
* This is intended for use when loading PackageItems from a
|
|
* configuration map. It will look up the various keys in the map
|
|
* and handle translation strings as well.
|
|
*/
|
|
PackageItem( const QVariantMap& map );
|
|
|
|
/** @brief Is this item valid?
|
|
*
|
|
* A valid item has an untranslated name available.
|
|
*/
|
|
bool isValid() const { return !name.isEmpty(); }
|
|
|
|
/** @brief Is this a (the) No-Package package?
|
|
*
|
|
* There should be at most one No-Package item in a collection
|
|
* of PackageItems. That one will be used to describe a
|
|
* "no package" situation.
|
|
*/
|
|
bool isNonePackage() const { return id.isEmpty(); }
|
|
};
|
|
|
|
using PackageList = QVector< PackageItem >;
|
|
|
|
class PackageListModel : public QAbstractListModel
|
|
{
|
|
public:
|
|
PackageListModel( PackageList&& items, QObject* parent );
|
|
PackageListModel( QObject* parent );
|
|
~PackageListModel() override;
|
|
|
|
/** @brief Add a package @p to the model
|
|
*
|
|
* Only valid packages are added -- that is, they must have a name.
|
|
*/
|
|
void addPackage( PackageItem&& p );
|
|
|
|
int rowCount( const QModelIndex& index ) const override;
|
|
QVariant data( const QModelIndex& index, int role ) const override;
|
|
|
|
/// @brief Direct (non-abstract) access to package data
|
|
const PackageItem& packageData( int r ) const { return m_packages[ r ]; }
|
|
/// @brief Direct (non-abstract) count of package data
|
|
int packageCount() const { return m_packages.count(); }
|
|
|
|
enum Roles : int
|
|
{
|
|
NameRole = Qt::DisplayRole,
|
|
DescriptionRole = Qt::UserRole,
|
|
ScreenshotRole,
|
|
IdRole
|
|
};
|
|
|
|
private:
|
|
PackageList m_packages;
|
|
};
|
|
|
|
#endif
|