This is a container for configuration of the snapping of the project. More...

#include <qgssnappingconfig.h>

Classes
class	IndividualLayerSettings
	This is a container of advanced configuration (per layer) of the snapping of the project. More...

Public Types
enum	ScaleDependencyMode { Disabled = 0 , Global = 1 , PerLayer = 2 }
	ScaleDependencyMode the scale dependency mode of snapping. More...

enum	SnappingType { Vertex = 1 , VertexAndSegment = 2 , Segment = 3 }
	SnappingType defines on what object the snapping is performed. More...

Public Member Functions
	QgsSnappingConfig (QgsProject *project=nullptr)
	Constructor with default parameters defined in global settings.

bool	addLayers (const QList< QgsMapLayer * > &layers)
	Adds the specified layers as individual layers to the configuration with standard configuration.

void	clearIndividualLayerSettings ()
	Removes all individual layer snapping settings.

bool	enabled () const
	Returns if snapping is enabled.

QHash< QgsVectorLayer *, QgsSnappingConfig::IndividualLayerSettings >	individualLayerSettings () const
	Returns individual snapping settings for all layers.

QgsSnappingConfig::IndividualLayerSettings	individualLayerSettings (QgsVectorLayer *vl) const
	Returns individual layer snappings settings (applied if mode is AdvancedConfiguration)

bool	intersectionSnapping () const
	Returns if the snapping on intersection is enabled.

double	maximumScale () const
	Returns the max scale (i.e.

double	minimumScale () const
	Returns the min scale (i.e.

Qgis::SnappingMode	mode () const
	Returns the mode (all layers, active layer, per layer settings)

bool	operator!= (const QgsSnappingConfig &other) const
	Compare this configuration to other.

bool	operator== (const QgsSnappingConfig &other) const

QgsProject *	project () const
	The project from which the snapped layers should be retrieved.

void	readProject (const QDomDocument &doc)
	Reads the configuration from the specified QGIS project document.

bool	removeLayers (const QList< QgsMapLayer * > &layers)
	Removes the specified layers from the individual layer configuration.

void	reset ()
	reset to default values

ScaleDependencyMode	scaleDependencyMode () const
	Returns the scale dependency mode.

bool	selfSnapping () const
	Returns if self snapping (snapping to the currently digitized feature) is enabled.

void	setEnabled (bool enabled)
	enables the snapping

void	setIndividualLayerSettings (QgsVectorLayer *vl, const QgsSnappingConfig::IndividualLayerSettings &individualLayerSettings)
	Sets individual layer snappings settings (applied if mode is AdvancedConfiguration)

void	setIntersectionSnapping (bool enabled)
	Sets if the snapping on intersection is enabled.

void	setMaximumScale (double maxScale)
	Set the max scale on which snapping is enabled, 0.0 disable scale limit.

void	setMinimumScale (double minScale)
	Sets the min scale on which snapping is enabled, 0.0 disable scale limit.

void	setMode (Qgis::SnappingMode mode)
	define the mode of snapping

void	setProject (QgsProject *project)
	The project from which the snapped layers should be retrieved.

void	setScaleDependencyMode (ScaleDependencyMode mode)
	Set the scale dependency mode.

void	setSelfSnapping (bool enabled)
	Sets if self snapping (snapping to the currently digitized feature) is enabled.

void	setTolerance (double tolerance)
	Sets the tolerance.

Q_DECL_DEPRECATED void	setType (QgsSnappingConfig::SnappingType type)
	define the type of snapping

void	setTypeFlag (Qgis::SnappingTypes type)
	define the type of snapping

void	setUnits (Qgis::MapToolUnit units)
	Sets the type of units.

double	tolerance () const
	Returns the tolerance.

Q_DECL_DEPRECATED QgsSnappingConfig::SnappingType	type () const
	Returns the flags type (vertices \| segments \| area \| centroid \| middle)

Qgis::SnappingTypes	typeFlag () const
	Returns the flags type (vertices \| segments \| area \| centroid \| middle)

Qgis::MapToolUnit	units () const
	Returns the type of units.

void	writeProject (QDomDocument &doc)
	Writes the configuration to the specified QGIS project document.

Static Public Member Functions
static Q_DECL_DEPRECATED QIcon	snappingTypeFlagToIcon (Qgis::SnappingType type)
	Convenient method to return an icon corresponding to the enum type Qgis::SnappingTypes.

static Q_DECL_DEPRECATED QString	snappingTypeFlagToString (Qgis::SnappingType type)
	Convenient method to return the translated name of the enum type Qgis::SnappingTypes.

static QIcon	snappingTypeToIcon (Qgis::SnappingType type)
	Convenient method to return an icon corresponding to the enum type Qgis::SnappingTypes.

static QString	snappingTypeToString (Qgis::SnappingType type)
	Convenient method to returns the translated name of the enum type Qgis::SnappingTypes.

Properties
bool	enabled

Qgis::SnappingMode	mode

QgsProject *	project

Detailed Description

This is a container for configuration of the snapping of the project.

Definition at line 36 of file qgssnappingconfig.h.

Member Enumeration Documentation

◆ ScaleDependencyMode

enum QgsSnappingConfig::ScaleDependencyMode

ScaleDependencyMode the scale dependency mode of snapping.

Since: QGIS 3.14

Enumerator
Disabled	No scale dependency.
Global	Scale dependency using global min max range.
PerLayer	Scale dependency using min max range per layer.

Definition at line 64 of file qgssnappingconfig.h.

◆ SnappingType

enum QgsSnappingConfig::SnappingType

SnappingType defines on what object the snapping is performed.

Deprecated:: since QGIS 3.12 use Qgis::SnappingTypes instead.

Enumerator
Vertex	On vertices only.
VertexAndSegment	Both on vertices and segments.
Segment	On segments only.

Definition at line 50 of file qgssnappingconfig.h.

Constructor & Destructor Documentation

◆ QgsSnappingConfig()

QgsSnappingConfig::QgsSnappingConfig ( QgsProject * project = nullptr )

explicit

Constructor with default parameters defined in global settings.

Definition at line 168 of file qgssnappingconfig.cpp.

Member Function Documentation

◆ addLayers()

bool QgsSnappingConfig::addLayers ( const QList< QgsMapLayer * > & layers )

Adds the specified layers as individual layers to the configuration with standard configuration.

When implementing a long-living QgsSnappingConfig (like the one in QgsProject) it is best to directly feed this with information from the layer registry.

Returns: true if changes have been done.

Definition at line 592 of file qgssnappingconfig.cpp.

◆ clearIndividualLayerSettings()

void QgsSnappingConfig::clearIndividualLayerSettings ( )

Removes all individual layer snapping settings.

Since: QGIS 3.16

Definition at line 415 of file qgssnappingconfig.cpp.

◆ enabled()

bool QgsSnappingConfig::enabled ( ) const

Returns if snapping is enabled.

Definition at line 235 of file qgssnappingconfig.cpp.

◆ individualLayerSettings() [1/2]

QHash< QgsVectorLayer *, QgsSnappingConfig::IndividualLayerSettings > QgsSnappingConfig::individualLayerSettings ( ) const

Returns individual snapping settings for all layers.

Definition at line 397 of file qgssnappingconfig.cpp.

◆ individualLayerSettings() [2/2]

QgsSnappingConfig::IndividualLayerSettings QgsSnappingConfig::individualLayerSettings ( QgsVectorLayer * vl ) const

Returns individual layer snappings settings (applied if mode is AdvancedConfiguration)

Definition at line 402 of file qgssnappingconfig.cpp.

◆ intersectionSnapping()

bool QgsSnappingConfig::intersectionSnapping ( ) const

Returns if the snapping on intersection is enabled.

Definition at line 377 of file qgssnappingconfig.cpp.

◆ maximumScale()

double QgsSnappingConfig::maximumScale ( ) const

Returns the max scale (i.e.

most "zoomed in" scale)

Since: QGIS 3.14

Definition at line 723 of file qgssnappingconfig.cpp.

◆ minimumScale()

double QgsSnappingConfig::minimumScale ( ) const

Returns the min scale (i.e.

most "zoomed out" scale)

Since: QGIS 3.14

Definition at line 713 of file qgssnappingconfig.cpp.

◆ mode()

Qgis::SnappingMode QgsSnappingConfig::mode ( ) const

Returns the mode (all layers, active layer, per layer settings)

Definition at line 249 of file qgssnappingconfig.cpp.

◆ operator!=()

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

Compare this configuration to other.

Definition at line 429 of file qgssnappingconfig.cpp.

◆ operator==()

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

Definition at line 175 of file qgssnappingconfig.cpp.

◆ project()

QgsProject * QgsSnappingConfig::project ( ) const

The project from which the snapped layers should be retrieved.

Definition at line 698 of file qgssnappingconfig.cpp.

◆ readProject()

void QgsSnappingConfig::readProject ( const QDomDocument & doc )

Reads the configuration from the specified QGIS project document.

Definition at line 442 of file qgssnappingconfig.cpp.

◆ removeLayers()

bool QgsSnappingConfig::removeLayers ( const QList< QgsMapLayer * > & layers )

Removes the specified layers from the individual layer configuration.

When implementing a long-living QgsSnappingConfig (like the one in QgsProject) it is best to directly feed this with information from the layer registry.

Returns: true if changes have been done.

Definition at line 613 of file qgssnappingconfig.cpp.

◆ reset()

void QgsSnappingConfig::reset ( )

reset to default values

Definition at line 190 of file qgssnappingconfig.cpp.

◆ scaleDependencyMode()

QgsSnappingConfig::ScaleDependencyMode QgsSnappingConfig::scaleDependencyMode ( ) const

Returns the scale dependency mode.

Since: QGIS 3.14

Definition at line 738 of file qgssnappingconfig.cpp.

◆ selfSnapping()

bool QgsSnappingConfig::selfSnapping ( ) const

Returns if self snapping (snapping to the currently digitized feature) is enabled.

Since: QGIS 3.14

Definition at line 387 of file qgssnappingconfig.cpp.

◆ setEnabled()

void QgsSnappingConfig::setEnabled ( bool enabled )

enables the snapping

Definition at line 240 of file qgssnappingconfig.cpp.

◆ setIndividualLayerSettings()

void QgsSnappingConfig::setIndividualLayerSettings	(	QgsVectorLayer *	vl,
		const QgsSnappingConfig::IndividualLayerSettings &	individualLayerSettings
	)

Sets individual layer snappings settings (applied if mode is AdvancedConfiguration)

Definition at line 420 of file qgssnappingconfig.cpp.

◆ setIntersectionSnapping()

void QgsSnappingConfig::setIntersectionSnapping ( bool enabled )

Sets if the snapping on intersection is enabled.

Definition at line 382 of file qgssnappingconfig.cpp.

◆ setMaximumScale()

void QgsSnappingConfig::setMaximumScale ( double maxScale )

Set the max scale on which snapping is enabled, 0.0 disable scale limit.

Since: QGIS 3.14

Definition at line 728 of file qgssnappingconfig.cpp.

◆ setMinimumScale()

void QgsSnappingConfig::setMinimumScale ( double minScale )

Sets the min scale on which snapping is enabled, 0.0 disable scale limit.

Since: QGIS 3.14

Definition at line 718 of file qgssnappingconfig.cpp.

◆ setMode()

void QgsSnappingConfig::setMode ( Qgis::SnappingMode mode )

define the mode of snapping

Definition at line 254 of file qgssnappingconfig.cpp.

◆ setProject()

void QgsSnappingConfig::setProject ( QgsProject * project )

The project from which the snapped layers should be retrieved.

Definition at line 703 of file qgssnappingconfig.cpp.

◆ setScaleDependencyMode()

void QgsSnappingConfig::setScaleDependencyMode ( QgsSnappingConfig::ScaleDependencyMode mode )

Set the scale dependency mode.

Since: QGIS 3.14

Definition at line 733 of file qgssnappingconfig.cpp.

◆ setSelfSnapping()

void QgsSnappingConfig::setSelfSnapping ( bool enabled )

Sets if self snapping (snapping to the currently digitized feature) is enabled.

Since: QGIS 3.14

Definition at line 392 of file qgssnappingconfig.cpp.

◆ setTolerance()

void QgsSnappingConfig::setTolerance ( double tolerance )

Sets the tolerance.

Definition at line 354 of file qgssnappingconfig.cpp.

◆ setType()

void QgsSnappingConfig::setType ( QgsSnappingConfig::SnappingType type )

define the type of snapping

Deprecated:: since QGIS 3.12 use setTypeFlag instead.

Definition at line 322 of file qgssnappingconfig.cpp.

◆ setTypeFlag()

void QgsSnappingConfig::setTypeFlag ( Qgis::SnappingTypes type )

define the type of snapping

Since: QGIS 3.12

Definition at line 340 of file qgssnappingconfig.cpp.

◆ setUnits()

void QgsSnappingConfig::setUnits ( Qgis::MapToolUnit units )

Sets the type of units.

Definition at line 368 of file qgssnappingconfig.cpp.

◆ snappingTypeFlagToIcon()

static Q_DECL_DEPRECATED QIcon QgsSnappingConfig::snappingTypeFlagToIcon ( Qgis::SnappingType type )

inlinestatic

Convenient method to return an icon corresponding to the enum type Qgis::SnappingTypes.

Deprecated:: since QGIS 3.26 use Qgis::snappingTypeToString instead

Since: QGIS 3.20

Definition at line 101 of file qgssnappingconfig.h.

◆ snappingTypeFlagToString()

static Q_DECL_DEPRECATED QString QgsSnappingConfig::snappingTypeFlagToString ( Qgis::SnappingType type )

inlinestatic

Convenient method to return the translated name of the enum type Qgis::SnappingTypes.

Since: QGIS 3.12

Deprecated:: since QGIS 3.26 use Qgis::snappingTypeToString instead

Definition at line 85 of file qgssnappingconfig.h.

◆ snappingTypeToIcon()

QIcon QgsSnappingConfig::snappingTypeToIcon ( Qgis::SnappingType type )

static

Convenient method to return an icon corresponding to the enum type Qgis::SnappingTypes.

Since: QGIS 3.20

Definition at line 300 of file qgssnappingconfig.cpp.

◆ snappingTypeToString()

QString QgsSnappingConfig::snappingTypeToString ( Qgis::SnappingType type )

static

Convenient method to returns the translated name of the enum type Qgis::SnappingTypes.

Since: QGIS 3.26

Definition at line 278 of file qgssnappingconfig.cpp.

◆ tolerance()

double QgsSnappingConfig::tolerance ( ) const

Returns the tolerance.

Definition at line 349 of file qgssnappingconfig.cpp.

◆ type()

QgsSnappingConfig::SnappingType QgsSnappingConfig::type ( ) const

Returns the flags type (vertices | segments | area | centroid | middle)

Deprecated:: since QGIS 3.12 use typeFlag instead.

Definition at line 268 of file qgssnappingconfig.cpp.

◆ typeFlag()

Qgis::SnappingTypes QgsSnappingConfig::typeFlag ( ) const

Returns the flags type (vertices | segments | area | centroid | middle)

Since: QGIS 3.12

Definition at line 263 of file qgssnappingconfig.cpp.

◆ units()

Qgis::MapToolUnit QgsSnappingConfig::units ( ) const

Returns the type of units.

Definition at line 363 of file qgssnappingconfig.cpp.

◆ writeProject()

void QgsSnappingConfig::writeProject ( QDomDocument & doc )

Writes the configuration to the specified QGIS project document.

Definition at line 557 of file qgssnappingconfig.cpp.

Property Documentation

◆ enabled

bool QgsSnappingConfig::enabled

readwrite

Definition at line 41 of file qgssnappingconfig.h.

◆ mode

Qgis::SnappingMode QgsSnappingConfig::mode

readwrite

Definition at line 42 of file qgssnappingconfig.h.

◆ project

QgsProject * QgsSnappingConfig::project

readwrite

Definition at line 40 of file qgssnappingconfig.h.

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

/build/qgis-3.36.0+99sid/src/core/qgssnappingconfig.h
/build/qgis-3.36.0+99sid/src/core/qgssnappingconfig.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Member Enumeration Documentation

◆ ScaleDependencyMode

◆ SnappingType

Constructor & Destructor Documentation

◆ QgsSnappingConfig()

Member Function Documentation

◆ addLayers()

◆ clearIndividualLayerSettings()

◆ enabled()

◆ individualLayerSettings() [1/2]

◆ individualLayerSettings() [2/2]

◆ intersectionSnapping()

◆ maximumScale()

◆ minimumScale()

◆ mode()

◆ operator!=()

◆ operator==()

◆ project()

◆ readProject()

◆ removeLayers()

◆ reset()

◆ scaleDependencyMode()

◆ selfSnapping()

◆ setEnabled()

◆ setIndividualLayerSettings()

◆ setIntersectionSnapping()

◆ setMaximumScale()

◆ setMinimumScale()

◆ setMode()

◆ setProject()

◆ setScaleDependencyMode()

◆ setSelfSnapping()

◆ setTolerance()

◆ setType()

◆ setTypeFlag()

◆ setUnits()

◆ snappingTypeFlagToIcon()

◆ snappingTypeFlagToString()

◆ snappingTypeToIcon()

◆ snappingTypeToString()

◆ tolerance()

◆ type()

◆ typeFlag()

◆ units()

◆ writeProject()

Property Documentation

◆ enabled

◆ mode

◆ project