QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsfeaturefiltermodel.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsfeaturefiltermodel.h - QgsFeatureFilterModel
3 ---------------------
4 begin : 10.3.2017
5 copyright : (C) 2017 by Matthias Kuhn
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15#ifndef QGSFEATUREFILTERMODEL_H
16#define QGSFEATUREFILTERMODEL_H
17
18
20
28{
29 Q_OBJECT
30
36 Q_PROPERTY( QStringList identifierFields READ identifierFields WRITE setIdentifierFields NOTIFY identifierFieldsChanged )
37
38
41 Q_PROPERTY( QVariantList extraIdentifierValues READ extraIdentifierValues WRITE setExtraIdentifierValues NOTIFY extraIdentifierValuesChanged )
42
43 public:
44
48 explicit QgsFeatureFilterModel( QObject *parent = nullptr );
49
56 Q_DECL_DEPRECATED QString identifierField() const;
57
63 QStringList identifierFields() const;
64
71 void setIdentifierFields( const QStringList &identifierFields );
72
78 void setExtraIdentifierValueToNull() override;
79
85 QVariantList extraIdentifierValues() const;
86
92 void setExtraIdentifierValues( const QVariantList &extraIdentifierValues );
93
94
95 signals:
96
102
108
109 private:
110 QgsFeatureExpressionValuesGatherer *createValuesGatherer( const QgsFeatureRequest &request ) const override;
111
113
114 QSet<QString> requestedAttributes() const override;
115
116 QVariant entryIdentifier( const QgsFeatureExpressionValuesGatherer::Entry &entry ) const override;
117
118 QgsFeatureExpressionValuesGatherer::Entry createEntry( const QVariant &identifier ) const override;
119
120 bool compareEntries( const QgsFeatureExpressionValuesGatherer::Entry &a, const QgsFeatureExpressionValuesGatherer::Entry &b ) const override;
121
122 bool identifierIsNull( const QVariant &identifier ) const override;
123
124 QVariant nullIdentifier() const override;
125
126 QStringList mIdentifierFields;
127};
128
129#endif // QGSFEATUREFILTERMODEL_H
Provides a list of features based on filter conditions.
void extraIdentifierValuesChanged()
Allows specifying one value that does not need to match the filter criteria but will still be availab...
void identifierFieldsChanged()
The identifier field should be a unique field that can be used to identify individual features.
Provides a list of features based on filter conditions.
virtual QVariant entryIdentifier(const QgsFeatureExpressionValuesGatherer::Entry &entry) const =0
Returns the identifier of the given entry.
virtual void setExtraIdentifierValueToNull()=0
Allows specifying one value that does not need to match the filter criteria but will still be availab...
virtual void requestToReloadCurrentFeature(QgsFeatureRequest &request)=0
Update the request to match the current feature to be reloaded.
virtual QgsFeatureExpressionValuesGatherer * createValuesGatherer(const QgsFeatureRequest &request) const =0
Creates the value gatherer.
virtual QSet< QString > requestedAttributes() const
Returns the attributes to be fetched in the request.
virtual QgsFeatureExpressionValuesGatherer::Entry createEntry(const QVariant &identifier) const =0
Creates an entry with just the identifier so the feature can be retrieved in a next iteration.
virtual bool identifierIsNull(const QVariant &identifier) const =0
Returns true if the entry is null The identifier can be either the feature ID or the list of identifi...
virtual bool compareEntries(const QgsFeatureExpressionValuesGatherer::Entry &a, const QgsFeatureExpressionValuesGatherer::Entry &b) const =0
Returns true if the 2 entries refers to the same feature.
virtual QVariant nullIdentifier() const =0
Returns a null identifier.
This class wraps a request for features to a vector layer (or directly its vector data provider).
#define SIP_FORCE
Definition: qgis_sip.h:131