QGIS API Documentation  3.24.2-Tisler (13c1a02865)
qgsvectorlayerutils.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsvectorlayerutils.h
3  ---------------------
4  Date : October 2016
5  Copyright : (C) 2016 by Nyall Dawson
6  Email : nyall dot dawson at gmail dot com
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 
16 #ifndef QGSVECTORLAYERUTILS_H
17 #define QGSVECTORLAYERUTILS_H
18 
19 #include "qgis_core.h"
20 #include "qgsgeometry.h"
22 #include "qgsfeaturesink.h"
23 
24 class QgsFeatureRenderer;
25 class QgsSymbolLayer;
26 class QgsSymbolLayerId;
27 
36 class CORE_EXPORT QgsVectorLayerUtils
37 {
38  public:
39 
47  class CORE_EXPORT QgsDuplicateFeatureContext
48  {
49  public:
50 
53 
58  QList<QgsVectorLayer *> layers() const;
59 
64  QgsFeatureIds duplicatedFeatures( QgsVectorLayer *layer ) const;
65 
66 
67  private:
68  QMap<QgsVectorLayer *, QgsFeatureIds> mDuplicatedFeatures;
69  friend class QgsVectorLayerUtils;
70 
75  void setDuplicatedFeatures( QgsVectorLayer *layer, const QgsFeatureIds &ids );
76  };
77 
85  class CORE_EXPORT QgsFeatureData
86  {
87  public:
88 
92  QgsFeatureData( const QgsGeometry &geometry = QgsGeometry(), const QgsAttributeMap &attributes = QgsAttributeMap() );
93 
95  QgsGeometry geometry() const;
96 
98  QgsAttributeMap attributes() const;
99 
100  private:
101  QgsGeometry mGeometry;
102  QgsAttributeMap mAttributes;
103  };
104 
105  // SIP does not like "using", use legacy typedef
107  typedef QList<QgsVectorLayerUtils::QgsFeatureData> QgsFeaturesDataList;
108 
118  static QgsFeatureIterator getValuesIterator( const QgsVectorLayer *layer, const QString &fieldOrExpression, bool &ok, bool selectedOnly );
119 
131  static QList< QVariant > getValues( const QgsVectorLayer *layer, const QString &fieldOrExpression, bool &ok, bool selectedOnly = false, QgsFeedback *feedback = nullptr );
132 
146  static QList< double > getDoubleValues( const QgsVectorLayer *layer, const QString &fieldOrExpression, bool &ok, bool selectedOnly = false, int *nullCount = nullptr, QgsFeedback *feedback = nullptr );
147 
154  static bool valueExists( const QgsVectorLayer *layer, int fieldIndex, const QVariant &value, const QgsFeatureIds &ignoreIds = QgsFeatureIds() );
155 
161  static QVariant createUniqueValue( const QgsVectorLayer *layer, int fieldIndex, const QVariant &seed = QVariant() );
162 
169  static QVariant createUniqueValueFromCache( const QgsVectorLayer *layer, int fieldIndex, const QSet<QVariant> &existingValues, const QVariant &seed = QVariant() );
170 
176  static bool validateAttribute( const QgsVectorLayer *layer, const QgsFeature &feature, int attributeIndex, QStringList &errors SIP_OUT,
179 
188  static QgsFeature createFeature( const QgsVectorLayer *layer,
189  const QgsGeometry &geometry = QgsGeometry(),
190  const QgsAttributeMap &attributes = QgsAttributeMap(),
191  QgsExpressionContext *context = nullptr );
192 
200  static QgsFeatureList createFeatures( const QgsVectorLayer *layer,
201  const QgsFeaturesDataList &featuresData,
202  QgsExpressionContext *context = nullptr );
203 
214  static QgsFeature duplicateFeature( QgsVectorLayer *layer, const QgsFeature &feature, QgsProject *project, QgsDuplicateFeatureContext &duplicateFeatureContext SIP_OUT, const int maxDepth = 0, int depth SIP_PYARGREMOVE = 0, QList<QgsVectorLayer *> referencedLayersBranch SIP_PYARGREMOVE = QList<QgsVectorLayer *>() );
215 
216 
231  static std::unique_ptr<QgsVectorLayerFeatureSource> getFeatureSource( QPointer<QgsVectorLayer> layer, QgsFeedback *feedback = nullptr ) SIP_SKIP;
232 
252  static void matchAttributesToFields( QgsFeature &feature, const QgsFields &fields );
253 
275  static QgsFeatureList makeFeatureCompatible( const QgsFeature &feature, const QgsVectorLayer *layer, QgsFeatureSink::SinkFlags sinkFlags = QgsFeatureSink::SinkFlags() );
276 
298  static QgsFeatureList makeFeaturesCompatible( const QgsFeatureList &features, const QgsVectorLayer *layer, QgsFeatureSink::SinkFlags sinkFlags = QgsFeatureSink::SinkFlags() );
299 
308  static bool fieldIsEditable( const QgsVectorLayer *layer, int fieldIndex, const QgsFeature &feature );
309 
319  static bool fieldIsReadOnly( const QgsVectorLayer *layer, int fieldIndex );
320 
330  static bool fieldEditabilityDependsOnFeature( const QgsVectorLayer *layer, int fieldIndex );
331 
339  static QHash<QString, QHash<QString, QSet<QgsSymbolLayerId>>> labelMasks( const QgsVectorLayer * ) SIP_SKIP;
340 
348  static QHash<QString, QSet<QgsSymbolLayerId>> symbolLayerMasks( const QgsVectorLayer * ) SIP_SKIP;
349 
355  static QString getFeatureDisplayString( const QgsVectorLayer *layer, const QgsFeature &feature );
356 
363  {
364  IgnoreAuxiliaryLayers = 1 << 1,
365  };
366  Q_DECLARE_FLAGS( CascadedFeatureFlags, CascadedFeatureFlag )
367 
368 
374  static bool impactsCascadeFeatures( const QgsVectorLayer *layer, const QgsFeatureIds &fids, const QgsProject *project, QgsDuplicateFeatureContext &context SIP_OUT, QgsVectorLayerUtils::CascadedFeatureFlags flags = QgsVectorLayerUtils::CascadedFeatureFlags() );
375 
376 #ifndef SIP_RUN
377 
398 #else
399 
417 #endif
418  static QString guessFriendlyIdentifierField( const QgsFields &fields, bool *foundFriendly SIP_OUT = nullptr ) SIP_PYNAME( guessFriendlyIdentifierFieldV2 );
419 
420 #ifdef SIP_RUN
421 
438  static QString guessFriendlyIdentifierField( const QgsFields &fields );
439 #endif
440 
441 };
442 
443 
444 #endif // QGSVECTORLAYERUTILS_H
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
Wrapper for iterator of features from vector data provider or vector layer.
An interface for objects which accept features via addFeature(s) methods.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition: qgsfeature.h:56
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition: qgsfeedback.h:45
ConstraintStrength
Strength of constraints.
@ ConstraintStrengthNotSet
Constraint is not set.
ConstraintOrigin
Origin of constraints.
@ ConstraintOriginNotSet
Constraint is not set.
Container of fields for a vector layer.
Definition: qgsfields.h:45
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:125
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:101
We may need stable references to symbol layers, when pointers to symbol layers is not usable (when a ...
Contains mainly the QMap with QgsVectorLayer and QgsFeatureIds do list all the duplicated features.
QgsDuplicateFeatureContext()=default
Constructor for QgsDuplicateFeatureContext.
Encapsulate geometry and attributes for new features, to be passed to createFeatures.
Contains utility methods for working with QgsVectorLayers.
QList< QgsVectorLayerUtils::QgsFeatureData > QgsFeaturesDataList
Alias for list of QgsFeatureData.
CascadedFeatureFlag
Flags that can be used when determining cascaded features.
Represents a vector layer which manages a vector based data sets.
#define SIP_SKIP
Definition: qgis_sip.h:126
#define SIP_PYNAME(name)
Definition: qgis_sip.h:81
#define SIP_PYARGREMOVE
Definition: qgis_sip.h:146
#define SIP_OUT
Definition: qgis_sip.h:58
QMap< int, QVariant > QgsAttributeMap
Definition: qgsattributes.h:38
QList< QgsFeature > QgsFeatureList
Definition: qgsfeature.h:882
QSet< QgsFeatureId > QgsFeatureIds
Definition: qgsfeatureid.h:37