QGIS API Documentation 3.39.0-Master (04dac197d13)
|
Stores queued vector layer edit operations prior to committing changes to the layer's data provider. More...
#include <qgsvectorlayereditbuffer.h>
Signals | |
void | attributeAdded (int idx) |
void | attributeDeleted (int idx) |
void | attributeRenamed (int idx, const QString &newName) |
Emitted when an attribute has been renamed. | |
void | attributeValueChanged (QgsFeatureId fid, int idx, const QVariant &) |
void | committedAttributesAdded (const QString &layerId, const QList< QgsField > &addedAttributes) |
void | committedAttributesDeleted (const QString &layerId, const QgsAttributeList &deletedAttributes) |
Signals emitted after committing changes. | |
void | committedAttributesRenamed (const QString &layerId, const QgsFieldNameMap &renamedAttributes) |
Emitted after committing an attribute rename. | |
void | committedAttributeValuesChanges (const QString &layerId, const QgsChangedAttributesMap &changedAttributesValues) |
void | committedFeaturesAdded (const QString &layerId, const QgsFeatureList &addedFeatures) |
void | committedFeaturesRemoved (const QString &layerId, const QgsFeatureIds &deletedFeatureIds) |
void | committedGeometriesChanges (const QString &layerId, const QgsGeometryMap &changedGeometries) |
void | featureAdded (QgsFeatureId fid) |
void | featureDeleted (QgsFeatureId fid) |
void | geometryChanged (QgsFeatureId fid, const QgsGeometry &geom) |
Emitted when a feature's geometry is changed. | |
void | layerModified () |
Emitted when modifications has been done on layer. | |
Public Member Functions | |
QgsVectorLayerEditBuffer (QgsVectorLayer *layer) | |
virtual bool | addAttribute (const QgsField &field) |
Adds an attribute field (but does not commit it) returns true if the field was added. | |
QList< QgsField > | addedAttributes () const |
Returns a list of added attributes fields which are not committed. | |
QgsFeatureMap | addedFeatures () const |
Returns a map of new features which are not committed. | |
virtual bool | addFeature (QgsFeature &f) |
Adds a feature. | |
virtual bool | addFeatures (QgsFeatureList &features) |
Insert a copy of the given features into the layer (but does not commit it) | |
QgsFeatureIds | allAddedOrEditedFeatures () const |
Returns a list of the features IDs for all newly added or edited features in the buffer. | |
virtual bool | changeAttributeValue (QgsFeatureId fid, int field, const QVariant &newValue, const QVariant &oldValue=QVariant()) |
Changed an attribute value (but does not commit it) | |
virtual bool | changeAttributeValues (QgsFeatureId fid, const QgsAttributeMap &newValues, const QgsAttributeMap &oldValues) |
Changes values of attributes (but does not commit it). | |
QgsChangedAttributesMap | changedAttributeValues () const |
Returns a map of features with changed attributes values which are not committed. | |
QgsGeometryMap | changedGeometries () const |
Returns a map of features with changed geometries which are not committed. | |
virtual bool | changeGeometry (QgsFeatureId fid, const QgsGeometry &geom) |
Change feature's geometry. | |
virtual bool | commitChanges (QStringList &commitErrors) |
Attempts to commit any changes to disk. | |
virtual bool | deleteAttribute (int attr) |
Deletes an attribute field (but does not commit it) | |
QgsAttributeList | deletedAttributeIds () const |
Returns a list of deleted attributes fields which are not committed. | |
QgsFeatureIds | deletedFeatureIds () const |
Returns a list of deleted feature IDs which are not committed. | |
virtual bool | deleteFeature (QgsFeatureId fid) |
Delete a feature from the layer (but does not commit it) | |
virtual bool | deleteFeatures (const QgsFeatureIds &fid) |
Deletes a set of features from the layer (but does not commit it) | |
QgsVectorLayerEditBufferGroup * | editBufferGroup () const |
Returns the parent edit buffer group for this edit buffer, or nullptr if not part of a group. | |
bool | isAttributeDeleted (int index) const |
Returns true if the specified attribute has been deleted but not committed. | |
bool | isFeatureAdded (QgsFeatureId id) const |
Returns true if the specified feature ID has been added but not committed. | |
bool | isFeatureAttributesChanged (QgsFeatureId id) const |
Returns true if the specified feature ID has had an attribute changed but not committed. | |
bool | isFeatureDeleted (QgsFeatureId id) const |
Returns true if the specified feature ID has been deleted but not committed. | |
bool | isFeatureGeometryChanged (QgsFeatureId id) const |
Returns true if the specified feature ID has had its geometry changed but not committed. | |
virtual bool | isModified () const |
Returns true if the provider has been modified since the last commit. | |
virtual bool | renameAttribute (int attr, const QString &newName) |
Renames an attribute field (but does not commit it) | |
virtual void | rollBack () |
Stop editing and discard the edits. | |
void | setEditBufferGroup (QgsVectorLayerEditBufferGroup *editBufferGroup) |
Set the parent edit buffer group for this edit buffer. | |
void | updateFields (QgsFields &fields) |
Updates fields. | |
Protected Slots | |
void | undoIndexChanged (int index) |
Protected Member Functions | |
QgsVectorLayerEditBuffer ()=default | |
void | handleAttributeAdded (int index) |
Update added and changed features after addition of an attribute. | |
void | handleAttributeDeleted (int index) |
Update added and changed features after removal of an attribute. | |
void | updateAttributeMapIndex (QgsAttributeMap &attrs, int index, int offset) const |
Updates an index in an attribute map to a new value (for updates of changed attributes) | |
void | updateChangedAttributes (QgsFeature &f) |
Update feature with uncommitted attribute updates. | |
void | updateFeatureGeometry (QgsFeature &f) |
Update feature with uncommitted geometry updates. | |
void | updateLayerFields () |
Protected Attributes | |
QgsVectorLayer * | L = nullptr |
QList< QgsField > | mAddedAttributes |
Added attributes fields which are not committed. | |
QgsFeatureMap | mAddedFeatures |
New features which are not committed. | |
int | mBlockModifiedSignals = 0 |
QgsChangedAttributesMap | mChangedAttributeValues |
Changed attributes values which are not committed. | |
QgsGeometryMap | mChangedGeometries |
Changed geometries which are not committed. | |
QgsAttributeList | mDeletedAttributeIds |
Deleted attributes fields which are not committed. The list is kept sorted. | |
QgsFeatureIds | mDeletedFeatureIds |
Deleted feature IDs which are not committed. | |
QgsVectorLayerEditBufferGroup * | mEditBufferGroup = nullptr |
QgsFieldNameMap | mRenamedAttributes |
Renamed attributes which are not committed. | |
Stores queued vector layer edit operations prior to committing changes to the layer's data provider.
Definition at line 38 of file qgsvectorlayereditbuffer.h.
QgsVectorLayerEditBuffer::QgsVectorLayerEditBuffer | ( | QgsVectorLayer * | layer | ) |
Definition at line 42 of file qgsvectorlayereditbuffer.cpp.
|
protecteddefault |
|
virtual |
Adds an attribute field (but does not commit it) returns true
if the field was added.
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 303 of file qgsvectorlayereditbuffer.cpp.
|
inline |
Returns a list of added attributes fields which are not committed.
Definition at line 161 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns a map of new features which are not committed.
Definition at line 115 of file qgsvectorlayereditbuffer.h.
|
virtual |
Adds a feature.
f | feature to add |
true
in case of success and false
in case of error Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 132 of file qgsvectorlayereditbuffer.cpp.
|
virtual |
Insert a copy of the given features into the layer (but does not commit it)
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 151 of file qgsvectorlayereditbuffer.cpp.
QgsFeatureIds QgsVectorLayerEditBuffer::allAddedOrEditedFeatures | ( | ) | const |
Returns a list of the features IDs for all newly added or edited features in the buffer.
Definition at line 483 of file qgsvectorlayereditbuffer.cpp.
|
signal |
|
signal |
|
signal |
Emitted when an attribute has been renamed.
idx | attribute index |
newName | new attribute name |
|
signal |
|
virtual |
Changed an attribute value (but does not commit it)
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 281 of file qgsvectorlayereditbuffer.cpp.
|
virtual |
Changes values of attributes (but does not commit it).
true
if attributes are well updated, false
otherwise Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 255 of file qgsvectorlayereditbuffer.cpp.
|
inline |
Returns a map of features with changed attributes values which are not committed.
Definition at line 136 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns a map of features with changed geometries which are not committed.
Definition at line 167 of file qgsvectorlayereditbuffer.h.
|
virtual |
Change feature's geometry.
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 234 of file qgsvectorlayereditbuffer.cpp.
|
virtual |
Attempts to commit any changes to disk.
Returns the result of the attempt. If a commit fails, the in-memory changes are left alone.
This allows editing to continue if the commit failed on e.g. a disallowed value in a Postgres database - the user can re-edit and try again.
The commits occur in distinct stages, (add attributes, add features, change attribute values, change geometries, delete features, delete attributes) so if a stage fails, it's difficult to roll back cleanly. Therefore any error message also includes which stage failed so that the user has some chance of repairing the damage cleanly.
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 371 of file qgsvectorlayereditbuffer.cpp.
|
signal |
|
signal |
Signals emitted after committing changes.
|
signal |
Emitted after committing an attribute rename.
layerId | ID of layer |
renamedAttributes | map of field index to new name |
|
signal |
|
signal |
|
signal |
|
signal |
|
virtual |
Deletes an attribute field (but does not commit it)
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 326 of file qgsvectorlayereditbuffer.cpp.
|
inline |
Returns a list of deleted attributes fields which are not committed.
The list is kept sorted.
Definition at line 149 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns a list of deleted feature IDs which are not committed.
Definition at line 180 of file qgsvectorlayereditbuffer.h.
|
virtual |
Delete a feature from the layer (but does not commit it)
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 182 of file qgsvectorlayereditbuffer.cpp.
|
virtual |
Deletes a set of features from the layer (but does not commit it)
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 211 of file qgsvectorlayereditbuffer.cpp.
QgsVectorLayerEditBufferGroup * QgsVectorLayerEditBuffer::editBufferGroup | ( | ) | const |
Returns the parent edit buffer group for this edit buffer, or nullptr if not part of a group.
Definition at line 88 of file qgsvectorlayereditbuffer.cpp.
|
signal |
|
signal |
|
signal |
Emitted when a feature's geometry is changed.
fid | feature ID |
geom | new feature geometry |
|
protected |
Update added and changed features after addition of an attribute.
Definition at line 505 of file qgsvectorlayereditbuffer.cpp.
|
protected |
Update added and changed features after removal of an attribute.
Definition at line 539 of file qgsvectorlayereditbuffer.cpp.
|
inline |
Returns true
if the specified attribute has been deleted but not committed.
index | attribute index |
Definition at line 156 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns true
if the specified feature ID has been added but not committed.
id | feature ID |
Definition at line 130 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns true
if the specified feature ID has had an attribute changed but not committed.
id | feature ID |
Definition at line 143 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns true
if the specified feature ID has been deleted but not committed.
id | feature ID |
Definition at line 187 of file qgsvectorlayereditbuffer.h.
|
inline |
Returns true
if the specified feature ID has had its geometry changed but not committed.
id | feature ID |
Definition at line 174 of file qgsvectorlayereditbuffer.h.
|
virtual |
Returns true
if the provider has been modified since the last commit.
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 48 of file qgsvectorlayereditbuffer.cpp.
|
signal |
Emitted when modifications has been done on layer.
|
virtual |
Renames an attribute field (but does not commit it)
attr | attribute index |
newName | new name of field |
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 348 of file qgsvectorlayereditbuffer.cpp.
|
virtual |
Stop editing and discard the edits.
Reimplemented in QgsVectorLayerEditPassthrough.
Definition at line 467 of file qgsvectorlayereditbuffer.cpp.
void QgsVectorLayerEditBuffer::setEditBufferGroup | ( | QgsVectorLayerEditBufferGroup * | editBufferGroup | ) |
Set the parent edit buffer group for this edit buffer.
Definition at line 93 of file qgsvectorlayereditbuffer.cpp.
|
protectedslot |
Definition at line 54 of file qgsvectorlayereditbuffer.cpp.
|
protected |
Updates an index in an attribute map to a new value (for updates of changed attributes)
Definition at line 585 of file qgsvectorlayereditbuffer.cpp.
|
protected |
Update feature with uncommitted attribute updates.
Definition at line 105 of file qgsvectorlayereditbuffer.cpp.
|
protected |
Update feature with uncommitted geometry updates.
Definition at line 98 of file qgsvectorlayereditbuffer.cpp.
void QgsVectorLayerEditBuffer::updateFields | ( | QgsFields & | fields | ) |
Updates fields.
Definition at line 66 of file qgsvectorlayereditbuffer.cpp.
|
protected |
Definition at line 598 of file qgsvectorlayereditbuffer.cpp.
|
friend |
Definition at line 326 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 330 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 277 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 282 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 278 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 281 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 280 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 283 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 279 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 284 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 286 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 292 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 287 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 290 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 291 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 289 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 293 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 288 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 294 of file qgsvectorlayereditbuffer.h.
|
friend |
Definition at line 295 of file qgsvectorlayereditbuffer.h.
|
protected |
Definition at line 275 of file qgsvectorlayereditbuffer.h.
|
protected |
Added attributes fields which are not committed.
Definition at line 314 of file qgsvectorlayereditbuffer.h.
|
protected |
New features which are not committed.
Definition at line 305 of file qgsvectorlayereditbuffer.h.
|
protected |
Definition at line 324 of file qgsvectorlayereditbuffer.h.
|
protected |
Changed attributes values which are not committed.
Definition at line 308 of file qgsvectorlayereditbuffer.h.
|
protected |
Changed geometries which are not committed.
Definition at line 320 of file qgsvectorlayereditbuffer.h.
|
protected |
Deleted attributes fields which are not committed. The list is kept sorted.
Definition at line 311 of file qgsvectorlayereditbuffer.h.
|
protected |
Deleted feature IDs which are not committed.
Note a feature can be added and then deleted again before the change is committed - in that case the added feature would be removed from mAddedFeatures only and not entered here.
Definition at line 302 of file qgsvectorlayereditbuffer.h.
|
protected |
Definition at line 322 of file qgsvectorlayereditbuffer.h.
|
protected |
Renamed attributes which are not committed.
Definition at line 317 of file qgsvectorlayereditbuffer.h.