qgsfeaturefiltermodel.h

Go to the documentation of this file.

/***************************************************************************
  qgsfeaturefiltermodel.h - QgsFeatureFilterModel
 ---------------------
 begin                : 10.3.2017
 copyright            : (C) 2017 by Matthias Kuhn
 email                : [email protected]
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSFEATUREFILTERMODEL_H
#define QGSFEATUREFILTERMODEL_H

#include <QAbstractItemModel>

#include "qgsconditionalstyle.h"

class QgsFieldExpressionValuesGatherer;

class CORE_EXPORT QgsFeatureFilterModel : public QAbstractItemModel
{
    Q_OBJECT

    Q_PROPERTY( QgsVectorLayer *sourceLayer READ sourceLayer WRITE setSourceLayer NOTIFY sourceLayerChanged )
    Q_PROPERTY( QString displayExpression READ displayExpression WRITE setDisplayExpression NOTIFY displayExpressionChanged )
    Q_PROPERTY( QString filterValue READ filterValue WRITE setFilterValue NOTIFY filterValueChanged )
    Q_PROPERTY( QString filterExpression READ filterExpression WRITE setFilterExpression NOTIFY filterExpressionChanged )
    Q_PROPERTY( bool allowNull READ allowNull WRITE setAllowNull NOTIFY allowNullChanged )
    Q_PROPERTY( bool isLoading READ isLoading NOTIFY isLoadingChanged )

    Q_PROPERTY( QString identifierField READ identifierField WRITE setIdentifierField NOTIFY identifierFieldChanged )

    Q_PROPERTY( QVariant extraIdentifierValue READ extraIdentifierValue WRITE setExtraIdentifierValue NOTIFY extraIdentifierValueChanged )

    Q_PROPERTY( int extraIdentifierValueIndex READ extraIdentifierValueIndex NOTIFY extraIdentifierValueIndexChanged )

  public:

    enum Role
    {
      IdentifierValueRole = Qt::UserRole, 
      IdentifierValuesRole, 
      ValueRole 
    };

    explicit QgsFeatureFilterModel( QObject *parent = nullptr );
    ~QgsFeatureFilterModel() override;

    QgsVectorLayer *sourceLayer() const;

    void setSourceLayer( QgsVectorLayer *sourceLayer );

    QString displayExpression() const;

    void setDisplayExpression( const QString &displayExpression );

    QString filterValue() const;

    void setFilterValue( const QString &filterValue );

    QModelIndex index( int row, int column, const QModelIndex &parent ) const override;
    QModelIndex parent( const QModelIndex &child ) const override;
    int rowCount( const QModelIndex &parent ) const override;
    int columnCount( const QModelIndex &parent ) const override;
    QVariant data( const QModelIndex &index, int role ) const override;

    QString filterExpression() const;

    void setFilterExpression( const QString &filterExpression );

    bool isLoading() const;

    Q_DECL_DEPRECATED QString identifierField() const;

    QStringList identifierFields() const;

    Q_DECL_DEPRECATED void setIdentifierField( const QString &identifierField );

    void setIdentifierFields( const QStringList &identifierFields );

    Q_DECL_DEPRECATED QVariant extraIdentifierValue() const;

    QVariantList extraIdentifierValues() const;

    Q_DECL_DEPRECATED void setExtraIdentifierValue( const QVariant &extraIdentifierValue );

    void setExtraIdentifierValues( const QVariantList &extraIdentifierValues );

    void setExtraIdentifierValuesToNull();

    int extraIdentifierValueIndex() const;

    bool extraValueDoesNotExist() const;

    bool allowNull() const;

    void setAllowNull( bool allowNull );

  signals:

    void sourceLayerChanged();

    void displayExpressionChanged();

    void filterValueChanged();

    void filterExpressionChanged();

    void isLoadingChanged();

    void identifierFieldChanged();

    void filterJobCompleted();

    void extraIdentifierValueChanged();

    void extraIdentifierValueIndexChanged( int index );

    void extraValueDoesNotExistChanged();

    void beginUpdate();

    void endUpdate();

    void allowNullChanged();

  private slots:
    void updateCompleter();
    void gathererThreadFinished();
    void scheduledReload();

  private:
    QSet<QString> requestedAttributes() const;
    void setExtraIdentifierValuesIndex( int index, bool force = false );
    void setExtraValueDoesNotExist( bool extraValueDoesNotExist );
    void reload();
    void reloadCurrentFeature();
    void setExtraIdentifierValuesUnguarded( const QVariantList &extraIdentifierValues );
    struct Entry
    {
      Entry() = default;

      Entry( const QVariantList &_identifierValues, const QString &_value, const QgsFeature &_feature )
        : identifierValues( _identifierValues )
        , value( _value )
        , feature( _feature )
      {}

      QVariantList identifierValues;
      QString value;
      QgsFeature feature;

      bool operator()( const Entry &lhs, const Entry &rhs ) const;
    };
    Entry nullEntry();

    QgsConditionalStyle featureStyle( const QgsFeature &feature ) const;

    QgsVectorLayer *mSourceLayer = nullptr;
    QgsExpression mDisplayExpression;
    QString mFilterValue;
    QString mFilterExpression;

    mutable QgsExpressionContext mExpressionContext;
    mutable QMap< QgsFeatureId, QgsConditionalStyle > mEntryStylesMap;
    QVector<Entry> mEntries;
    QgsFieldExpressionValuesGatherer *mGatherer = nullptr;
    QTimer mReloadTimer;
    bool mShouldReloadCurrentFeature = false;
    bool mExtraValueDoesNotExist = false;
    bool mAllowNull = false;
    bool mIsSettingExtraIdentifierValue = false;

    QStringList mIdentifierFields;
    QVariantList mExtraIdentifierValues;

    int mExtraIdentifierValueIndex = -1;

    friend class QgsFieldExpressionValuesGatherer;
};

#endif // QGSFEATUREFILTERMODEL_H