MarblePlacemarkModel.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2006-2007 Torsten Rahn <tackat@kde.org>
// SPDX-FileCopyrightText: 2007 Inge Wallin <ingwa@kde.org>
//
 
//
// MarblePlacemarkModel exposes the model for Placemarks
//
 
#ifndef MARBLE_MARBLEPLACEMARKMODEL_H
#define MARBLE_MARBLEPLACEMARKMODEL_H
 
 
#include <QAbstractListModel>
#include <QModelIndex>
 
#include "marble_export.h"
 
namespace Marble
{
 
class GeoDataCoordinates;
class GeoDataPlacemark;
 
/**
 * This class represents a model of all place marks which
 * are currently available through a given PlacemarkManager.
 */
class MARBLE_EXPORT MarblePlacemarkModel : public QAbstractListModel
{
    friend class PlacemarkManager;
 
    Q_OBJECT
 
    Q_PROPERTY( int count READ rowCount NOTIFY countChanged )
 
 public:
    /**
     * The roles of the place marks.
     */
    enum Roles
    {
      GeoTypeRole = Qt::UserRole + 1,  ///< The geo type (e.g. city or mountain)
      DescriptionRole,                 ///< The description
      CoordinateRole,                  ///< The GeoDataCoordinates coordinate
      PopulationRole,                  ///< The population
      AreaRole,                        ///< The area size
      CountryCodeRole,                 ///< The country code
      StateRole,                       ///< The state
      VisualCategoryRole,              ///< The category
      StyleRole,                       ///< The style
      PopularityIndexRole,             ///< The popularity index
      PopularityRole,                  ///< The popularity
      ObjectPointerRole,               ///< The pointer to a specific object
      GmtRole,                         ///< The Greenwich Mean Time
      DstRole,                         ///< The Daylight Saving Time
      GeometryRole,                    ///< The GeoDataGeometry geometry
      LongitudeRole,                   ///< The longitude in degree (for use in QML)
      LatitudeRole,                    ///< The latitude in degree (for use in QML)
      IconPathRole                     ///< Path to the image, if known
    };
 
    /**
     * Creates a new place mark model.
     *
     * @param parent The parent object.
     */
    explicit MarblePlacemarkModel( QObject *parent = nullptr );
 
    /**
     * Destroys the place mark model.
     */
    ~MarblePlacemarkModel() override;
 
    void setPlacemarkContainer( QVector<GeoDataPlacemark*> *container );
 
    /**
     * Return the number of Placemarks in the Model.
     */
    int rowCount( const QModelIndex &parent = QModelIndex() ) const override;
    int columnCount( const QModelIndex &parent = QModelIndex() ) const override;
 
    /**
     * Return the supported role names
     */
    QHash<int, QByteArray> roleNames() const override;
 
    /**
     * Return the data according to the index.
     *
     * @param index  the index of the data
     * @param role   which part of the data to return.  @see Roles
     */
    QVariant data( const QModelIndex &index, int role ) const override;
 
    QModelIndexList approxMatch( const QModelIndex &start, int role, 
                                   const QVariant &value, int hits = 1,
                                   Qt::MatchFlags flags = Qt::MatchFlags( Qt::MatchStartsWith | Qt::MatchWrap ) ) const;
 
    /**
     * This method is used by the PlacemarkManager to add new
     * place marks to the model.
     */
    void addPlacemarks( int start,
                        int length );
 
    /**
     * This method is used by the PlacemarkManager to remove
     * place marks from the model.
     */
    void removePlacemarks( const QString &containerName,
                           int start,
                           int length );
 
Q_SIGNALS:
    void countChanged();
 
 private:
 
    Q_DISABLE_COPY( MarblePlacemarkModel )
    class Private;
    Private* const d;
    QHash<int, QByteArray> m_roleNames;
};
 
}
 
#endif