#include <qgsvectorlayereditutils.h>

Public Member Functions
	QgsVectorLayerEditUtils (QgsVectorLayer *layer)

QgsGeometry::OperationResult	addPart (const QList< QgsPointXY > &ring, QgsFeatureId featureId)
	Adds a new part polygon to a multipart feature. More...

QgsGeometry::OperationResult	addPart (const QgsPointSequence &ring, QgsFeatureId featureId)
	Adds a new part polygon to a multipart feature. More...

QgsGeometry::OperationResult	addPart (QgsCurve *ring, QgsFeatureId featureId)
	Adds a new part polygon to a multipart feature. More...

QgsGeometry::OperationResult	addRing (const QVector< QgsPointXY > &ring, const QgsFeatureIds &targetFeatureIds=QgsFeatureIds(), QgsFeatureId *modifiedFeatureId=nullptr)
	Adds a ring to polygon/multipolygon features. More...

QgsGeometry::OperationResult	addRing (QgsCurve ring, const QgsFeatureIds &targetFeatureIds=QgsFeatureIds(), QgsFeatureId modifiedFeatureId=nullptr)
	Adds a ring to polygon/multipolygon features. More...

int	addTopologicalPoints (const QgsGeometry &geom)
	Adds topological points for every vertex of the geometry. More...

int	addTopologicalPoints (const QgsPointXY &p)
	Adds a vertex to segments which intersect point p but don't already have a vertex there. More...

QgsVectorLayer::EditResult	deleteVertex (QgsFeatureId featureId, int vertex)
	Deletes a vertex from a feature. More...

bool	insertVertex (double x, double y, QgsFeatureId atFeatureId, int beforeVertex)
	Insert a new vertex before the given vertex number, in the given ring, item (first number is index 0), and feature Not meaningful for Point geometries. More...

bool	insertVertex (const QgsPoint &point, QgsFeatureId atFeatureId, int beforeVertex)
	Inserts a new vertex before the given vertex number, in the given ring, item (first number is index 0), and feature Not meaningful for Point geometries. More...

bool	moveVertex (double x, double y, QgsFeatureId atFeatureId, int atVertex)
	Moves the vertex at the given position number, ring and item (first number is index 0), and feature to the given coordinates. More...

bool	moveVertex (const QgsPoint &p, QgsFeatureId atFeatureId, int atVertex)
	Moves the vertex at the given position number, ring and item (first number is index 0), and feature to the given coordinates. More...

QgsGeometry::OperationResult	splitFeatures (const QVector< QgsPointXY > &splitLine, bool topologicalEditing=false)
	Splits features cut by the given line. More...

QgsGeometry::OperationResult	splitParts (const QVector< QgsPointXY > &splitLine, bool topologicalEditing=false)
	Splits parts cut by the given line. More...

int	translateFeature (QgsFeatureId featureId, double dx, double dy)
	Translates feature by dx, dy. More...

Detailed Description

Definition at line 31 of file qgsvectorlayereditutils.h.

Constructor & Destructor Documentation

◆ QgsVectorLayerEditUtils()

QgsVectorLayerEditUtils::QgsVectorLayerEditUtils ( QgsVectorLayer * layer )

Definition at line 32 of file qgsvectorlayereditutils.cpp.

Member Function Documentation

◆ addPart() [1/3]

QgsGeometry::OperationResult QgsVectorLayerEditUtils::addPart	(	const QList< QgsPointXY > &	ring,
		QgsFeatureId	featureId
	)

Adds a new part polygon to a multipart feature.

Returns

- QgsGeometry::Success

QgsGeometry::AddPartSelectedGeometryNotFound
QgsGeometry::AddPartNotMultiGeometry
QgsGeometry::InvalidBaseGeometry
QgsGeometry::InvalidInput

Definition at line 175 of file qgsvectorlayereditutils.cpp.

◆ addPart() [2/3]

QgsGeometry::OperationResult QgsVectorLayerEditUtils::addPart	(	const QgsPointSequence &	ring,
		QgsFeatureId	featureId
	)

Adds a new part polygon to a multipart feature.

Returns

- QgsGeometry::Success

QgsGeometry::AddPartSelectedGeometryNotFound
QgsGeometry::AddPartNotMultiGeometry
QgsGeometry::InvalidBaseGeometry
QgsGeometry::InvalidInput

Note: available in python bindings as addPartV2

Definition at line 185 of file qgsvectorlayereditutils.cpp.

◆ addPart() [3/3]

QgsGeometry::OperationResult QgsVectorLayerEditUtils::addPart	(	QgsCurve *	ring,
		QgsFeatureId	featureId
	)

Adds a new part polygon to a multipart feature.

Returns

- QgsGeometry::Success

QgsGeometry::AddPartSelectedGeometryNotFound
QgsGeometry::AddPartNotMultiGeometry
QgsGeometry::InvalidBaseGeometry
QgsGeometry::InvalidInput

Note: available in python bindings as addCurvedPart

Definition at line 220 of file qgsvectorlayereditutils.cpp.

◆ addRing() [1/2]

QgsGeometry::OperationResult QgsVectorLayerEditUtils::addRing	(	const QVector< QgsPointXY > &	ring,
		const QgsFeatureIds &	targetFeatureIds = `QgsFeatureIds()`,
		QgsFeatureId *	modifiedFeatureId = `nullptr`
	)

Adds a ring to polygon/multipolygon features.

Parameters

ring	ring to add
targetFeatureIds	if specified, only these features will be the candidates for adding a ring. Otherwise all intersecting features are tested and the ring is added to the first valid feature.
modifiedFeatureId	if specified, feature ID for feature that ring was added to will be stored in this parameter

Returns: OperationResult result code: success or reason of failure

Definition at line 119 of file qgsvectorlayereditutils.cpp.

◆ addRing() [2/2]

QgsGeometry::OperationResult QgsVectorLayerEditUtils::addRing	(	QgsCurve *	ring,
		const QgsFeatureIds &	targetFeatureIds = `QgsFeatureIds()`,
		QgsFeatureId *	modifiedFeatureId = `nullptr`
	)

Adds a ring to polygon/multipolygon features.

Parameters

ring	ring to add
targetFeatureIds	if specified, only these features will be the candidates for adding a ring. Otherwise all intersecting features are tested and the ring is added to the first valid feature.
modifiedFeatureId	if specified, feature ID for feature that ring was added to will be stored in this parameter

Returns: OperationResult result code: success or reason of failure

Note: available in python bindings as addCurvedRing

Definition at line 125 of file qgsvectorlayereditutils.cpp.

◆ addTopologicalPoints() [1/2]

int QgsVectorLayerEditUtils::addTopologicalPoints ( const QgsGeometry & geom )

Adds topological points for every vertex of the geometry.

Parameters

geom	the geometry where each vertex is added to segments of other features

Returns: 0 in case of success

Note: geom is not going to be modified by the function

Definition at line 503 of file qgsvectorlayereditutils.cpp.

◆ addTopologicalPoints() [2/2]

int QgsVectorLayerEditUtils::addTopologicalPoints ( const QgsPointXY & p )

Adds a vertex to segments which intersect point p but don't already have a vertex there.

If a feature already has a vertex at position p, no additional vertex is inserted. This method is useful for topological editing.

Parameters

p	position of the vertex

Returns: 0 in case of success

Definition at line 609 of file qgsvectorlayereditutils.cpp.

◆ deleteVertex()

QgsVectorLayer::EditResult QgsVectorLayerEditUtils::deleteVertex	(	QgsFeatureId	featureId,
		int	vertex
	)

Deletes a vertex from a feature.

Parameters

featureId	ID of feature to remove vertex from
vertex	index of vertex to delete

Since: QGIS 2.14

Definition at line 95 of file qgsvectorlayereditutils.cpp.

◆ insertVertex() [1/2]

bool QgsVectorLayerEditUtils::insertVertex	(	double	x,
		double	y,
		QgsFeatureId	atFeatureId,
		int	beforeVertex
	)

Insert a new vertex before the given vertex number, in the given ring, item (first number is index 0), and feature Not meaningful for Point geometries.

Definition at line 37 of file qgsvectorlayereditutils.cpp.

◆ insertVertex() [2/2]

bool QgsVectorLayerEditUtils::insertVertex	(	const QgsPoint &	point,
		QgsFeatureId	atFeatureId,
		int	beforeVertex
	)

Inserts a new vertex before the given vertex number, in the given ring, item (first number is index 0), and feature Not meaningful for Point geometries.

Definition at line 54 of file qgsvectorlayereditutils.cpp.

◆ moveVertex() [1/2]

bool QgsVectorLayerEditUtils::moveVertex	(	double	x,
		double	y,
		QgsFeatureId	atFeatureId,
		int	atVertex
	)

Moves the vertex at the given position number, ring and item (first number is index 0), and feature to the given coordinates.

Definition at line 71 of file qgsvectorlayereditutils.cpp.

◆ moveVertex() [2/2]

bool QgsVectorLayerEditUtils::moveVertex	(	const QgsPoint &	p,
		QgsFeatureId	atFeatureId,
		int	atVertex
	)

Moves the vertex at the given position number, ring and item (first number is index 0), and feature to the given coordinates.

Note: available in Python bindings as moveVertexV2

Definition at line 77 of file qgsvectorlayereditutils.cpp.

◆ splitFeatures()

QgsGeometry::OperationResult QgsVectorLayerEditUtils::splitFeatures	(	const QVector< QgsPointXY > &	splitLine,
		bool	topologicalEditing = `false`
	)

Splits features cut by the given line.

Parameters

splitLine	line that splits the layer features
topologicalEditing	true if topological editing is enabled

Returns: 0 in case of success, 4 if there is a selection but no feature split

Definition at line 276 of file qgsvectorlayereditutils.cpp.

◆ splitParts()

QgsGeometry::OperationResult QgsVectorLayerEditUtils::splitParts	(	const QVector< QgsPointXY > &	splitLine,
		bool	topologicalEditing = `false`
	)

Splits parts cut by the given line.

Parameters

splitLine	line that splits the layer feature parts
topologicalEditing	true if topological editing is enabled

Returns

- QgsGeometry::InvalidBaseGeometry

QgsGeometry::Success
QgsGeometry::InvalidInput
QgsGeometry::NothingHappened if a selection is present but no feature has been split
QgsGeometry::InvalidBaseGeometry
QgsGeometry::GeometryEngineError
QgsGeometry::SplitCannotSplitPoint

Definition at line 386 of file qgsvectorlayereditutils.cpp.

◆ translateFeature()

int QgsVectorLayerEditUtils::translateFeature	(	QgsFeatureId	featureId,
		double	dx,
		double	dy
	)

Translates feature by dx, dy.

Parameters

featureId	id of the feature to translate
dx	translation of x-coordinate
dy	translation of y-coordinate

Returns: 0 in case of success

Definition at line 256 of file qgsvectorlayereditutils.cpp.

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

/tmp/buildd/qgis-3.6.0+99unstable/src/core/qgsvectorlayereditutils.h
/tmp/buildd/qgis-3.6.0+99unstable/src/core/qgsvectorlayereditutils.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsVectorLayerEditUtils()

Member Function Documentation

◆ addPart() [1/3]

◆ addPart() [2/3]

◆ addPart() [3/3]

◆ addRing() [1/2]

◆ addRing() [2/2]

◆ addTopologicalPoints() [1/2]

◆ addTopologicalPoints() [2/2]

◆ deleteVertex()

◆ insertVertex() [1/2]

◆ insertVertex() [2/2]

◆ moveVertex() [1/2]

◆ moveVertex() [2/2]

◆ splitFeatures()

◆ splitParts()

◆ translateFeature()