Encapsulates settings relating to a feature source input to a processing algorithm. More...

#include <qgsprocessingparameters.h>

Public Member Functions
	QgsProcessingFeatureSourceDefinition (const QgsProperty &source, bool selectedFeaturesOnly=false, long long featureLimit=-1, Qgis::ProcessingFeatureSourceDefinitionFlags flags=Qgis::ProcessingFeatureSourceDefinitionFlags(), Qgis::InvalidGeometryCheck geometryCheck=Qgis::InvalidGeometryCheck::AbortOnInvalid, const QString &filterExpression=QString())
	Constructor for QgsProcessingFeatureSourceDefinition, accepting a QgsProperty source. More...

	QgsProcessingFeatureSourceDefinition (const QString &source=QString(), bool selectedFeaturesOnly=false, long long featureLimit=-1, Qgis::ProcessingFeatureSourceDefinitionFlags flags=Qgis::ProcessingFeatureSourceDefinitionFlags(), Qgis::InvalidGeometryCheck geometryCheck=Qgis::InvalidGeometryCheck::AbortOnInvalid, const QString &filterExpression=QString())
	Constructor for QgsProcessingFeatureSourceDefinition, accepting a static string source. More...

bool	loadVariant (const QVariantMap &map)
	Loads this source definition from a QVariantMap, wrapped in a QVariant. More...

	operator QVariant () const
	Allows direct construction of QVariants. More...

bool	operator!= (const QgsProcessingFeatureSourceDefinition &other) const

bool	operator== (const QgsProcessingFeatureSourceDefinition &other) const

QVariant	toVariant () const
	Saves this source definition to a QVariantMap, wrapped in a QVariant. More...

Public Attributes
long long	featureLimit = -1
	If set to a value > 0, places a limit on the maximum number of features which will be read from the source. More...

QString	filterExpression
	Optional expression filter to use for filtering features which will be read from the source. More...

Qgis::ProcessingFeatureSourceDefinitionFlags	flags
	Flags which dictate source behavior. More...

Qgis::InvalidGeometryCheck	geometryCheck = Qgis::InvalidGeometryCheck::AbortOnInvalid
	Geometry check method to apply to this source. More...

bool	selectedFeaturesOnly
	`true` if only selected features in the source should be used by algorithms. More...

QgsProperty	source
	Source definition. More...

Detailed Description

Encapsulates settings relating to a feature source input to a processing algorithm.

Definition at line 55 of file qgsprocessingparameters.h.

Constructor & Destructor Documentation

◆ QgsProcessingFeatureSourceDefinition() [1/2]

QgsProcessingFeatureSourceDefinition::QgsProcessingFeatureSourceDefinition	(	const QString &	source = `QString()`,
		bool	selectedFeaturesOnly = `false`,
		long long	featureLimit = `-1`,
		Qgis::ProcessingFeatureSourceDefinitionFlags	flags = `Qgis::ProcessingFeatureSourceDefinitionFlags()`,
		Qgis::InvalidGeometryCheck	geometryCheck = `Qgis::InvalidGeometryCheck::AbortOnInvalid`,
		const QString &	filterExpression = `QString()`
	)

inline

Constructor for QgsProcessingFeatureSourceDefinition, accepting a static string source.

If selectedFeaturesOnly is true, then only selected features from the source will be used.

The optional featureLimit can be set to a value > 0 to place a hard limit on the maximum number of features which will be read from the source.

Since QGIS 3.32, the optional filterExpression argument can be used to specify a expression to use to filter the features read from the source.

The flags argument can be used to specify flags which dictate the source behavior.

If the Qgis::ProcessingFeatureSourceDefinitionFlag::OverrideDefaultGeometryCheck is set in flags, then the value of geometryCheck will override the default geometry check method (as dictated by QgsProcessingContext) for this source.

Definition at line 75 of file qgsprocessingparameters.h.

◆ QgsProcessingFeatureSourceDefinition() [2/2]

QgsProcessingFeatureSourceDefinition::QgsProcessingFeatureSourceDefinition	(	const QgsProperty &	source,
		bool	selectedFeaturesOnly = `false`,
		long long	featureLimit = `-1`,
		Qgis::ProcessingFeatureSourceDefinitionFlags	flags = `Qgis::ProcessingFeatureSourceDefinitionFlags()`,
		Qgis::InvalidGeometryCheck	geometryCheck = `Qgis::InvalidGeometryCheck::AbortOnInvalid`,
		const QString &	filterExpression = `QString()`
	)

inline

Constructor for QgsProcessingFeatureSourceDefinition, accepting a QgsProperty source.

If selectedFeaturesOnly is true, then only selected features from the source will be used.

The optional featureLimit can be set to a value > 0 to place a hard limit on the maximum number of features which will be read from the source.

Since QGIS 3.32, the optional filterExpression argument can be used to specify a expression to use to filter the features read from the source.

The flags argument can be used to specify flags which dictate the source behavior.

If the Qgis::ProcessingFeatureSourceDefinitionFlag::OverrideDefaultGeometryCheck is set in flags, then the value of geometryCheck will override the default geometry check method (as dictated by QgsProcessingContext) for this source.

Definition at line 101 of file qgsprocessingparameters.h.

Member Function Documentation

◆ loadVariant()

bool QgsProcessingFeatureSourceDefinition::loadVariant ( const QVariantMap & map )

Loads this source definition from a QVariantMap, wrapped in a QVariant.

You can use QgsXmlUtils::readVariant to load it from an XML document.

See also: toVariant()

Since: QGIS 3.14

Definition at line 58 of file qgsprocessingparameters.cpp.

◆ operator QVariant()

QgsProcessingFeatureSourceDefinition::operator QVariant ( ) const

inline

Allows direct construction of QVariants.

Definition at line 185 of file qgsprocessingparameters.h.

◆ operator!=()

bool QgsProcessingFeatureSourceDefinition::operator!= ( const QgsProcessingFeatureSourceDefinition & other ) const

inline

Definition at line 179 of file qgsprocessingparameters.h.

◆ operator==()

bool QgsProcessingFeatureSourceDefinition::operator== ( const QgsProcessingFeatureSourceDefinition & other ) const

inline

Definition at line 169 of file qgsprocessingparameters.h.

◆ toVariant()

QVariant QgsProcessingFeatureSourceDefinition::toVariant ( ) const

Saves this source definition to a QVariantMap, wrapped in a QVariant.

You can use QgsXmlUtils::writeVariant to save it to an XML document.

See also: loadVariant()

Since: QGIS 3.14

Definition at line 46 of file qgsprocessingparameters.cpp.

Member Data Documentation

◆ featureLimit

long long QgsProcessingFeatureSourceDefinition::featureLimit = -1

If set to a value > 0, places a limit on the maximum number of features which will be read from the source.

Since: QGIS 3.14

Definition at line 127 of file qgsprocessingparameters.h.

◆ filterExpression

QString QgsProcessingFeatureSourceDefinition::filterExpression

Optional expression filter to use for filtering features which will be read from the source.

Since: QGIS 3.32

Definition at line 134 of file qgsprocessingparameters.h.

◆ flags

Qgis::ProcessingFeatureSourceDefinitionFlags QgsProcessingFeatureSourceDefinition::flags

Flags which dictate source behavior.

Since: QGIS 3.14

Definition at line 141 of file qgsprocessingparameters.h.

◆ geometryCheck

Qgis::InvalidGeometryCheck QgsProcessingFeatureSourceDefinition::geometryCheck = Qgis::InvalidGeometryCheck::AbortOnInvalid

Geometry check method to apply to this source.

This setting is only utilized if the Qgis::ProcessingFeatureSourceDefinitionFlag::OverrideDefaultGeometryCheck is set in QgsProcessingFeatureSourceDefinition::flags.

Since: QGIS 3.14

Definition at line 150 of file qgsprocessingparameters.h.

◆ selectedFeaturesOnly

bool QgsProcessingFeatureSourceDefinition::selectedFeaturesOnly

true if only selected features in the source should be used by algorithms.

Definition at line 119 of file qgsprocessingparameters.h.

◆ source

QgsProperty QgsProcessingFeatureSourceDefinition::source

Source definition.

Usually a static property set to a source layer's ID or file name.

Definition at line 114 of file qgsprocessingparameters.h.

The documentation for this class was generated from the following files:

/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/core/processing/qgsprocessingparameters.h
/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/core/processing/qgsprocessingparameters.cpp

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ QgsProcessingFeatureSourceDefinition() [1/2]

◆ QgsProcessingFeatureSourceDefinition() [2/2]

Member Function Documentation

◆ loadVariant()

◆ operator QVariant()

◆ operator!=()

◆ operator==()

◆ toVariant()

Member Data Documentation

◆ featureLimit

◆ filterExpression

◆ flags

◆ geometryCheck

◆ selectedFeaturesOnly

◆ source