Represents a vector layer which manages a vector based data sets. More...
#include <qgsvectorlayer.h>
Classes | |
| struct | DeleteContext |
| Context for cascade delete features. More... | |
| struct | LayerOptions |
| Setting options for loading vector layers. More... | |
Public Types | |
| enum | EditResult { Success = 0, EmptyGeometry = 1, EditFailed = 2, FetchFeatureFailed = 3, InvalidLayer = 4 } |
| Result of an edit operation. More... | |
| enum | SelectBehavior { SetSelection, AddToSelection, IntersectSelection, RemoveFromSelection } |
| Selection behavior. More... | |
| enum | VertexMarkerType { SemiTransparentCircle, Cross, NoMarker } |
| Editing vertex markers. More... | |
 Public Types inherited from QgsMapLayer | |
| enum | LayerFlag { Identifiable = 1 << 0, Removable = 1 << 1, Searchable = 1 << 2 } |
| Flags for the map layer. More... | |
| enum | PropertyType { Style = 0, Metadata } |
| Maplayer has a style and a metadata property. More... | |
| enum | ReadFlag { FlagDontResolveLayers = 1 << 0, FlagTrustLayerMetadata = 1 << 1 } |
| Flags which control project read behavior. More... | |
| enum | StyleCategory { LayerConfiguration = 1 << 0, Symbology = 1 << 1, Symbology3D = 1 << 2, Labeling = 1 << 3, Fields = 1 << 4, Forms = 1 << 5, Actions = 1 << 6, MapTips = 1 << 7, Diagrams = 1 << 8, AttributeTable = 1 << 9, Rendering = 1 << 10, CustomProperties = 1 << 11, GeometryOptions = 1 << 12, Relations = 1 << 13, Temporal = 1 << 14, Legend = 1 << 15, AllStyleCategories } |
| Categories of style to distinguish appropriate sections for import/export. More... | |
| Public Types inherited from QgsFeatureSink | |
| enum | Flag { FastInsert = 1 << 1, RollBackOnErrors = 1 << 2 } |
| Flags controlling how features are added to a sink. More... | |
| enum | SinkFlag { RegeneratePrimaryKey = 1 << 1 } |
| Flags that can be set on a QgsFeatureSink. More... | |
| Public Types inherited from QgsFeatureSource | |
| enum | FeatureAvailability { NoFeaturesAvailable, FeaturesAvailable, FeaturesMaybeAvailable } |
| Possible return value for hasFeatures() to determine if a source is empty. More... | |
| enum | SpatialIndexPresence { SpatialIndexUnknown = 0, SpatialIndexNotPresent = 1, SpatialIndexPresent = 2 } |
| Enumeration of spatial index presence states. More... | |
Public Slots | |
| bool | accept (QgsStyleEntityVisitorInterface *visitor) const override |
| Q_INVOKABLE void | deselect (const QgsFeatureIds &featureIds) |
| Deselects features by their ID. More... | |
| void | deselect (QgsFeatureId featureId) |
| Deselects feature by its ID. More... | |
| SpatialIndexPresence | hasSpatialIndex () const override |
| Q_INVOKABLE void | removeSelection () |
| Clear selection. More... | |
| void | reselect () |
| Reselects the previous set of selected features. More... | |
| Q_INVOKABLE void | select (const QgsFeatureIds &featureIds) |
| Selects features by their ID. More... | |
| void | select (QgsFeatureId featureId) |
| Selects feature by its ID. More... | |
| virtual void | setTransformContext (const QgsCoordinateTransformContext &transformContext) override |
| Sets the coordinate transform context to transformContext. More... | |
| Q_INVOKABLE bool | startEditing () |
| Makes the layer editable. More... | |
| virtual void | updateExtents (bool force=false) |
| Update the extents for the layer. More... | |
| Public Slots inherited from QgsMapLayer | |
| void | emitStyleChanged () |
| Triggers an emission of the styleChanged() signal. More... | |
| void | setMaximumScale (double scale) |
| Sets the maximum map scale (i.e. More... | |
| void | setMinimumScale (double scale) |
| Sets the minimum map scale (i.e. More... | |
| void | setRefreshOnNofifyMessage (const QString &message) |
| Set the notification message that triggers repaint If refresh on notification is enabled, the notification will triggerRepaint only if the notification message is equal to. More... | |
| void | setRefreshOnNotifyEnabled (bool enabled) |
| Set whether provider notification is connected to triggerRepaint. More... | |
| void | setScaleBasedVisibility (bool enabled) |
| Sets whether scale based visibility is enabled for the layer. More... | |
| virtual void | setTransformContext (const QgsCoordinateTransformContext &transformContext)=0 |
| Sets the coordinate transform context to transformContext. More... | |
| void | triggerRepaint (bool deferredUpdate=false) |
| Will advise the map canvas (and any other interested party) that this layer requires to be repainted. More... | |
Signals | |
| void | afterCommitChanges () |
| Emitted after changes are committed to the data provider. More... | |
| void | afterRollBack () |
| Emitted after changes are rolled back. More... | |
| void | allowCommitChanged () |
| Emitted whenever the allowCommitChanged() property of this layer changes. More... | |
| void | attributeAdded (int idx) |
| Will be emitted, when a new attribute has been added to this vector layer. More... | |
| void | attributeDeleted (int idx) |
| Will be emitted, when an attribute has been deleted from this vector layer. More... | |
| void | attributeValueChanged (QgsFeatureId fid, int idx, const QVariant &value) |
| Emitted whenever an attribute value change is done in the edit buffer. More... | |
| void | beforeAddingExpressionField (const QString &fieldName) |
| Will be emitted, when an expression field is going to be added to this vector layer. More... | |
| void | beforeCommitChanges (bool stopEditing) |
| Emitted before changes are committed to the data provider. More... | |
| void | beforeEditingStarted () |
| Emitted before editing on this layer is started. More... | |
| void | beforeModifiedCheck () const |
| Emitted when the layer is checked for modifications. Use for last-minute additions. More... | |
| void | beforeRemovingExpressionField (int idx) |
| Will be emitted, when an expression field is going to be deleted from this vector layer. More... | |
| void | beforeRollBack () |
| Emitted before changes are rolled back. More... | |
| void | committedAttributesAdded (const QString &layerId, const QList< QgsField > &addedAttributes) |
| Emitted when attributes are added to the provider. More... | |
| void | committedAttributesDeleted (const QString &layerId, const QgsAttributeList &deletedAttributes) |
| Emitted when attributes are deleted from the provider. More... | |
| void | committedAttributeValuesChanges (const QString &layerId, const QgsChangedAttributesMap &changedAttributesValues) |
| Emitted when attribute value changes are saved to the provider. More... | |
| void | committedFeaturesAdded (const QString &layerId, const QgsFeatureList &addedFeatures) |
| Emitted when features are added to the provider. More... | |
| void | committedFeaturesRemoved (const QString &layerId, const QgsFeatureIds &deletedFeatureIds) |
| Emitted when features are deleted from the provider. More... | |
| void | committedGeometriesChanges (const QString &layerId, const QgsGeometryMap &changedGeometries) |
| Emitted when geometry changes are saved to the provider. More... | |
| void | displayExpressionChanged () |
| Emitted when the display expression changes. More... | |
| void | editCommandDestroyed () |
| Signal emitted, when an edit command is destroyed. More... | |
| void | editCommandEnded () |
| Signal emitted, when an edit command successfully ended. More... | |
| void | editCommandStarted (const QString &text) |
| Signal emitted when a new edit command has been started. More... | |
| void | editFormConfigChanged () |
| Will be emitted whenever the edit form configuration of this layer changes. More... | |
| void | editingStarted () |
| Emitted when editing on this layer has started. More... | |
| void | editingStopped () |
| Emitted when edited changes have been successfully written to the data provider. More... | |
| void | featureAdded (QgsFeatureId fid) |
| Emitted when a new feature has been added to the layer. More... | |
| void | featureBlendModeChanged (QPainter::CompositionMode blendMode) |
| Signal emitted when setFeatureBlendMode() is called. More... | |
| void | featureDeleted (QgsFeatureId fid) |
| Emitted when a feature has been deleted. More... | |
| void | featuresDeleted (const QgsFeatureIds &fids) |
| Emitted when features have been deleted. More... | |
| void | geometryChanged (QgsFeatureId fid, const QgsGeometry &geometry) |
| Emitted whenever a geometry change is done in the edit buffer. More... | |
| void | labelingFontNotFound (QgsVectorLayer *layer, const QString &fontfamily) |
| Emitted when the font family defined for labeling layer is not found on system. More... | |
| void | layerModified () |
| Emitted when modifications has been done on layer. More... | |
| void | mapTipTemplateChanged () |
| Emitted when the map tip changes. More... | |
| void | opacityChanged (double opacity) |
| Emitted when the layer's opacity is changed, where opacity is a value between 0 (transparent) and 1 (opaque). More... | |
| void | raiseError (const QString &msg) |
| Signals an error related to this vector layer. More... | |
| void | readCustomSymbology (const QDomElement &element, QString &errorMessage) |
| Signal emitted whenever the symbology (QML-file) for this layer is being read. More... | |
| void | readOnlyChanged () |
| Emitted when the read only state of this layer is changed. More... | |
| void | selectionChanged (const QgsFeatureIds &selected, const QgsFeatureIds &deselected, bool clearAndSelect) |
| Emitted when selection was changed. More... | |
| void | subsetStringChanged () |
| Emitted when the layer's subset string has changed. More... | |
| void | symbolFeatureCountMapChanged () |
| Emitted when the feature count for symbols on this layer has been recalculated. More... | |
| void | updatedFields () |
| Emitted whenever the fields available from this layer have been changed. More... | |
| void | writeCustomSymbology (QDomElement &element, QDomDocument &doc, QString &errorMessage) const |
| Signal emitted whenever the symbology (QML-file) for this layer is being written. More... | |
| Signals inherited from QgsMapLayer | |
| void | autoRefreshIntervalChanged (int interval) |
| Emitted when the auto refresh interval changes. More... | |
| void | beforeResolveReferences (QgsProject *project) |
| Emitted when all layers are loaded and references can be resolved, just before the references of this layer are resolved. More... | |
| void | blendModeChanged (QPainter::CompositionMode blendMode) |
| Signal emitted when the blend mode is changed, through QgsMapLayer::setBlendMode() More... | |
| void | configChanged () |
| Emitted whenever the configuration is changed. More... | |
| void | crsChanged () |
| Emit a signal that layer's CRS has been reset. More... | |
| void | dataChanged () |
| Data of layer changed. More... | |
| void | dataSourceChanged () |
| Emitted whenever the layer's data source has been changed. More... | |
| void | dependenciesChanged () |
| Emitted when dependencies are changed. More... | |
| void | flagsChanged () |
| Emitted when layer's flags have been modified. More... | |
| void | isValidChanged () |
| Emitted when the validity of this layer changed. More... | |
| void | legendChanged () |
| Signal emitted when legend of the layer has changed. More... | |
| void | metadataChanged () |
| Emitted when the layer's metadata is changed. More... | |
| void | nameChanged () |
| Emitted when the name has been changed. More... | |
| void | recalculateExtents () const |
| This is used to send a request that any mapcanvas using this layer update its extents. More... | |
| void | renderer3DChanged () |
| Signal emitted when 3D renderer associated with the layer has changed. More... | |
| void | rendererChanged () |
| Signal emitted when renderer is changed. More... | |
| void | repaintRequested (bool deferredUpdate=false) |
| By emitting this signal the layer tells that either appearance or content have been changed and any view showing the rendered layer should refresh itself. More... | |
| void | statusChanged (const QString &status) |
| Emit a signal with status (e.g. to be caught by QgisApp and display a msg on status bar) More... | |
| void | styleChanged () |
| Signal emitted whenever a change affects the layer's style. More... | |
| void | styleLoaded (QgsMapLayer::StyleCategories categories) |
| Emitted when a style has been loaded. More... | |
| void | willBeDeleted () |
| Emitted in the destructor when the layer is about to be deleted, but it is still in a perfectly valid state: the last chance for other pieces of code for some cleanup if they use the layer. More... | |
Public Member Functions | |
| QgsVectorLayer (const QgsVectorLayer &rhs)=delete | |
| QgsVectorLayer cannot be copied. More... | |
| QgsVectorLayer (const QString &path=QString(), const QString &baseName=QString(), const QString &providerLib="ogr", const QgsVectorLayer::LayerOptions &options=QgsVectorLayer::LayerOptions()) | |
| Constructor - creates a vector layer. More... | |
| ~QgsVectorLayer () override | |
| QgsActionManager * | actions () |
| Returns all layer actions defined on this layer. More... | |
| const QgsActionManager * | actions () const |
| Returns all layer actions defined on this layer. More... | |
| bool | addAttribute (const QgsField &field) |
Add an attribute field (but does not commit it) returns true if the field was added. More... | |
| int | addExpressionField (const QString &exp, const QgsField &fld) |
| Add a new field which is calculated by the expression specified. More... | |
| bool | addFeature (QgsFeature &feature, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) FINAL |
| Adds a single feature to the sink. More... | |
| bool | addFeatures (QgsFeatureList &features, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) FINAL |
| Adds a list of features to the sink. More... | |
| bool | addJoin (const QgsVectorLayerJoinInfo &joinInfo) |
| Joins another vector layer to this layer. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | addPart (const QgsPointSequence &ring) |
| Adds a new part polygon to a multipart feature. More... | |
| Q_DECL_DEPRECATED QgsGeometry::OperationResult | addPart (const QList< QgsPointXY > &ring) |
| Adds a new part polygon to a multipart feature. More... | |
| Q_DECL_DEPRECATED QgsGeometry::OperationResult | addPart (const QVector< QgsPointXY > &ring) |
| Adds a new part polygon to a multipart feature. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | addPart (QgsCurve *ring) |
| Q_INVOKABLE QgsGeometry::OperationResult | addRing (const QgsPointSequence &ring, QgsFeatureId *featureId=nullptr) |
| Adds a ring to polygon/multipolygon features. More... | |
| Q_DECL_DEPRECATED QgsGeometry::OperationResult | addRing (const QVector< QgsPointXY > &ring, QgsFeatureId *featureId=nullptr) |
| Adds a ring to polygon/multipolygon features. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | addRing (QgsCurve *ring, QgsFeatureId *featureId=nullptr) |
| Adds a ring to polygon/multipolygon features (takes ownership) More... | |
| int | addTopologicalPoints (const QgsGeometry &geom) |
| Adds topological points for every vertex of the geometry. More... | |
| int | addTopologicalPoints (const QgsPoint &p) |
| Adds a vertex to segments which intersect point p but don't already have a vertex there. More... | |
| int | addTopologicalPoints (const QgsPointSequence &ps) |
| Adds a vertex to segments which intersect any of the points p but don't already have a vertex there. More... | |
| Q_DECL_DEPRECATED int | addTopologicalPoints (const QgsPointXY &p) |
| Adds a vertex to segments which intersect point p but don't already have a vertex there. More... | |
| QVariant | aggregate (QgsAggregateCalculator::Aggregate aggregate, const QString &fieldOrExpression, const QgsAggregateCalculator::AggregateParameters ¶meters=QgsAggregateCalculator::AggregateParameters(), QgsExpressionContext *context=nullptr, bool *ok=nullptr, QgsFeatureIds *fids=nullptr) const |
| Calculates an aggregated value from the layer's features. More... | |
| bool | allowCommit () const |
| Controls, if the layer is allowed to commit changes. More... | |
| QString | attributeAlias (int index) const |
| Returns the alias of an attribute name or a null string if there is no alias. More... | |
| QgsStringMap | attributeAliases () const |
| Returns a map of field name to attribute alias. More... | |
| QString | attributeDisplayName (int index) const |
| Convenience function that returns the attribute alias if defined or the field name else. More... | |
| QgsAttributeList | attributeList () const |
| Returns list of attribute indexes. More... | |
| QgsAttributeTableConfig | attributeTableConfig () const |
| Returns the attribute table configuration object. More... | |
| QgsAuxiliaryLayer * | auxiliaryLayer () |
| Returns the current auxiliary layer. More... | |
| const QgsAuxiliaryLayer * | auxiliaryLayer () const |
| Returns the current const auxiliary layer. More... | |
| void | beginEditCommand (const QString &text) |
| Create edit command for undo/redo operations. More... | |
| Q_INVOKABLE QgsRectangle | boundingBoxOfSelected () const |
| Returns the bounding box of the selected features. If there is no selection, QgsRectangle(0,0,0,0) is returned. More... | |
| QString | capabilitiesString () const |
| Capabilities for this layer, comma separated and translated. More... | |
| bool | changeAttributeValue (QgsFeatureId fid, int field, const QVariant &newValue, const QVariant &oldValue=QVariant(), bool skipDefaultValues=false) |
| Changes an attribute value for a feature (but does not immediately commit the changes). More... | |
| bool | changeAttributeValues (QgsFeatureId fid, const QgsAttributeMap &newValues, const QgsAttributeMap &oldValues=QgsAttributeMap(), bool skipDefaultValues=false) |
| Changes attributes' values for a feature (but does not immediately commit the changes). More... | |
| bool | changeGeometry (QgsFeatureId fid, QgsGeometry &geometry, bool skipDefaultValue=false) |
| Changes a feature's geometry within the layer's edit buffer (but does not immediately commit the changes). More... | |
| QgsVectorLayer * | clone () const override |
| Returns a new instance equivalent to this one. More... | |
| Q_INVOKABLE bool | commitChanges (bool stopEditing=true) |
| Attempts to commit to the underlying data provider any buffered changes made since the last to call to startEditing(). More... | |
| QStringList | commitErrors () const |
| Returns a list containing any error messages generated when attempting to commit changes to the layer. More... | |
| QgsConditionalLayerStyles * | conditionalStyles () const |
| Returns the conditional styles that are set for this layer. More... | |
| QString | constraintDescription (int index) const |
| Returns the descriptive name for the constraint expression for a specified field index. More... | |
| QString | constraintExpression (int index) const |
| Returns the constraint expression for for a specified field index, if set. More... | |
| QgsVectorLayerFeatureCounter * | countSymbolFeatures (bool storeSymbolFids=false) |
| Count features for symbols. More... | |
| QgsExpressionContext | createExpressionContext () const FINAL |
| This method needs to be reimplemented in all classes which implement this interface and return an expression context. More... | |
| QgsExpressionContextScope * | createExpressionContextScope () const FINAL |
| This method needs to be reimplemented in all classes which implement this interface and return an expression context scope. More... | |
| QgsMapLayerRenderer * | createMapRenderer (QgsRenderContext &rendererContext) FINAL |
| Returns new instance of QgsMapLayerRenderer that will be used for rendering of given context. More... | |
| QString | dataComment () const |
| Returns a description for this layer as defined in the data provider. More... | |
| const QgsVectorDataProvider * | dataProvider () const FINAL |
Returns the layer's data provider in a const-correct manner, it may be nullptr. More... | |
| QgsVectorDataProvider * | dataProvider () FINAL |
Returns the layer's data provider, it may be nullptr. More... | |
| QString | decodedSource (const QString &source, const QString &provider, const QgsReadWriteContext &context) const FINAL |
| Called by readLayerXML(), used by derived classes to decode provider's specific data source from project files. More... | |
| QVariant | defaultValue (int index, const QgsFeature &feature=QgsFeature(), QgsExpressionContext *context=nullptr) const |
| Returns the calculated default value for the specified field index. More... | |
| QgsDefaultValue | defaultValueDefinition (int index) const |
| Returns the definition of the expression used when calculating the default value for a field. More... | |
| virtual bool | deleteAttribute (int attr) |
| Deletes an attribute field (but does not commit it). More... | |
| bool | deleteAttributes (const QList< int > &attrs) |
| Deletes a list of attribute fields (but does not commit it) More... | |
| bool | deleteFeature (QgsFeatureId fid, DeleteContext *context=nullptr) |
| Deletes a feature from the layer (but does not commit it). More... | |
| bool | deleteFeatures (const QgsFeatureIds &fids, DeleteContext *context=nullptr) |
| Deletes a set of features from the layer (but does not commit it) More... | |
| Q_INVOKABLE bool | deleteSelectedFeatures (int *deletedCount=nullptr, DeleteContext *context=nullptr) |
| Deletes the selected features. More... | |
| virtual bool | deleteStyleFromDatabase (const QString &styleId, QString &msgError) |
| Deletes a style from the database. More... | |
| EditResult | deleteVertex (QgsFeatureId featureId, int vertex) |
| Deletes a vertex from a feature. More... | |
| QSet< QgsMapLayerDependency > | dependencies () const FINAL |
| Gets the list of dependencies. More... | |
| void | destroyEditCommand () |
| Destroy active command and reverts all changes in it. More... | |
| const QgsDiagramLayerSettings * | diagramLayerSettings () const |
| const QgsDiagramRenderer * | diagramRenderer () const |
| bool | diagramsEnabled () const |
| Returns whether the layer contains diagrams which are enabled and should be drawn. More... | |
| QString | displayExpression () const |
| Returns the preview expression, used to create a human readable preview string. More... | |
| QString | displayField () const |
| This is a shorthand for accessing the displayExpression if it is a simple field. More... | |
| Q_INVOKABLE QgsVectorLayerEditBuffer * | editBuffer () |
| Buffer with uncommitted editing operations. Only valid after editing has been turned on. More... | |
| const QgsVectorLayerEditBuffer * | editBuffer () const |
| Buffer with uncommitted editing operations. More... | |
| QgsEditFormConfig | editFormConfig () const |
| Returns the configuration of the form used to represent this vector layer. More... | |
| QgsEditorWidgetSetup | editorWidgetSetup (int index) const |
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field at index. More... | |
| QString | encodedSource (const QString &source, const QgsReadWriteContext &context) const FINAL |
| Called by writeLayerXML(), used by derived classes to encode provider's specific data source to project files. More... | |
| void | endEditCommand () |
| Finish edit command and add it to undo/redo stack. More... | |
| Q_DECL_DEPRECATED QSet< QString > | excludeAttributesWfs () const |
| A set of attributes that are not advertised in WFS requests with QGIS server. More... | |
| Q_DECL_DEPRECATED QSet< QString > | excludeAttributesWms () const |
| A set of attributes that are not advertised in WMS requests with QGIS server. More... | |
| QString | expressionField (int index) const |
| Returns the expression used for a given expression field. More... | |
| QgsRectangle | extent () const FINAL |
| Returns the extent of the layer. More... | |
| QPainter::CompositionMode | featureBlendMode () const |
| Returns the current blending mode for features. More... | |
| long | featureCount () const FINAL |
| Returns feature count including changes which have not yet been committed If you need only the count of committed features call this method on this layer's provider. More... | |
| long | featureCount (const QString &legendKey) const |
| Number of features rendered with specified legend key. More... | |
| QgsField::ConfigurationFlags | fieldConfigurationFlags (int index) const |
| Returns the configuration flags of the field at given index. More... | |
| QgsFieldConstraints::Constraints | fieldConstraints (int fieldIndex) const |
| Returns any constraints which are present for a specified field index. More... | |
| QMap< QgsFieldConstraints::Constraint, QgsFieldConstraints::ConstraintStrength > | fieldConstraintsAndStrength (int fieldIndex) const |
| Returns a map of constraint with their strength for a specific field of the layer. More... | |
| QgsFields | fields () const FINAL |
| Returns the list of fields of this layer. More... | |
| QgsGeometryOptions * | geometryOptions () const |
| Configuration and logic to apply automatically on any edit happening on this layer. More... | |
| Q_INVOKABLE QgsWkbTypes::GeometryType | geometryType () const |
| Returns point, line or polygon. More... | |
| QgsFeature | getFeature (QgsFeatureId fid) const |
| Queries the layer for the feature with the given id. More... | |
| QgsFeatureIterator | getFeatures (const QgsFeatureIds &fids) |
| Queries the layer for the features with the given ids. More... | |
| QgsFeatureIterator | getFeatures (const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL |
| Queries the layer for features specified in request. More... | |
| QgsFeatureIterator | getFeatures (const QgsRectangle &rectangle) |
| Queries the layer for the features which intersect the specified rectangle. More... | |
| QgsFeatureIterator | getFeatures (const QString &expression) |
| Queries the layer for features matching a given expression. More... | |
| QgsGeometry | getGeometry (QgsFeatureId fid) const |
| Queries the layer for the geometry at the given id. More... | |
| QgsFeatureIterator | getSelectedFeatures (QgsFeatureRequest request=QgsFeatureRequest()) const |
| Returns an iterator of the selected features. More... | |
| virtual QString | getStyleFromDatabase (const QString &styleId, QString &msgError) |
| Returns the named style corresponding to style id provided. More... | |
| FeatureAvailability | hasFeatures () const FINAL |
| Determines if this vector layer has features. More... | |
| QString | htmlMetadata () const FINAL |
| Obtain a formatted HTML string containing assorted metadata for this layer. 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. More... | |
| bool | insertVertex (double x, double y, 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. More... | |
| Q_INVOKABLE void | invertSelection () |
| Selects not selected features and deselects selected ones. More... | |
| Q_INVOKABLE void | invertSelectionInRectangle (QgsRectangle &rect) |
| Inverts selection of features found within the search rectangle (in layer's coordinates) More... | |
| bool | isAuxiliaryField (int index, int &srcIndex) const |
Returns true if the field comes from the auxiliary layer, false otherwise. More... | |
| bool | isEditable () const FINAL |
Returns true if the provider is in editing mode. More... | |
| bool | isEditCommandActive () const |
| Tests if an edit command is active. More... | |
| virtual bool | isModified () const |
Returns true if the provider has been modified since the last commit. More... | |
| bool | isSpatial () const FINAL |
Returns true if this is a geometry layer and false in case of NoGeometry (table only) or UnknownGeometry. More... | |
| QgsVectorLayerJoinBuffer * | joinBuffer () |
| Returns the join buffer object. More... | |
| const QgsVectorLayerJoinBuffer * | joinBuffer () const |
| Returns a const pointer on join buffer object. More... | |
| QgsAbstractVectorLayerLabeling * | labeling () |
| Access to labeling configuration. More... | |
| const QgsAbstractVectorLayerLabeling * | labeling () const |
| Access to const labeling configuration. More... | |
| bool | labelsEnabled () const |
| Returns whether the layer contains labels which are enabled and should be drawn. More... | |
| virtual int | listStylesInDatabase (QStringList &ids, QStringList &names, QStringList &descriptions, QString &msgError) |
| Lists all the style in db split into related to the layer and not related to. More... | |
| bool | loadAuxiliaryLayer (const QgsAuxiliaryStorage &storage, const QString &key=QString()) |
| Loads the auxiliary layer for this vector layer. More... | |
| QString | loadDefaultStyle (bool &resultFlag) FINAL |
| Retrieve the default style for this layer if one exists (either as a .qml file on disk or as a record in the users style table in their personal qgis.db) More... | |
| virtual QString | loadNamedStyle (const QString &theURI, bool &resultFlag, bool loadFromLocalDb, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) |
| Loads a named style from file/local db/datasource db. More... | |
| QString | loadNamedStyle (const QString &theURI, bool &resultFlag, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) FINAL |
Calls loadNamedStyle( theURI, resultFlag, false ); Retained for backward compatibility. More... | |
| QString | mapTipTemplate () const |
| The mapTip is a pretty, html representation for feature information. More... | |
| QVariant | maximumValue (int index) const FINAL |
| Returns the maximum value for an attribute column or an invalid variant in case of error. More... | |
| QVariant | minimumValue (int index) const FINAL |
| Returns the minimum value for an attribute column or an invalid variant in case of error. More... | |
| Q_INVOKABLE void | modifySelection (const QgsFeatureIds &selectIds, const QgsFeatureIds &deselectIds) |
| Modifies the current selection on this layer. 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... | |
| 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... | |
| double | opacity () const |
| Returns the opacity for the vector layer, where opacity is a value between 0 (totally transparent) and 1.0 (fully opaque). More... | |
| QgsVectorLayer & | operator= (QgsVectorLayer const &rhs)=delete |
| QgsVectorLayer cannot be copied. More... | |
| QgsAttributeList | primaryKeyAttributes () const |
| Returns the list of attributes which make up the layer's primary keys. More... | |
| bool | readExtentFromXml () const |
Returns true if the extent is read from the XML document when data source has no metadata, false if it's the data provider which determines it. More... | |
| bool | readSld (const QDomNode &node, QString &errorMessage) FINAL |
| bool | readStyle (const QDomNode &node, QString &errorMessage, QgsReadWriteContext &context, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) FINAL |
| Reads the style for the current layer from the Dom node supplied. More... | |
| bool | readSymbology (const QDomNode &layerNode, QString &errorMessage, QgsReadWriteContext &context, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) FINAL |
| Reads the symbology for the current layer from the Dom node supplied. More... | |
| bool | readXml (const QDomNode &layer_node, QgsReadWriteContext &context) FINAL |
| Reads vector layer specific state from project file Dom node. More... | |
| QList< QgsRelation > | referencingRelations (int idx) const |
| Returns the layer's relations, where the foreign key is on this layer. More... | |
| void | reload () FINAL |
| Synchronises with changes in the datasource. More... | |
| void | removeExpressionField (int index) |
| Removes an expression field. More... | |
| void | removeFieldAlias (int index) |
| Removes an alias (a display name) for attributes to display in dialogs. More... | |
| void | removeFieldConstraint (int index, QgsFieldConstraints::Constraint constraint) |
| Removes a constraint for a specified field index. More... | |
| bool | removeJoin (const QString &joinLayerId) |
| Removes a vector layer join. More... | |
| bool | renameAttribute (int index, const QString &newName) |
| Renames an attribute field (but does not commit it). More... | |
| QgsFeatureRenderer * | renderer () |
| Returns renderer. More... | |
| const QgsFeatureRenderer * | renderer () const |
| Returns const renderer. More... | |
| void | resolveReferences (QgsProject *project) FINAL |
| Resolves references to other layers (kept as layer IDs after reading XML) into layer objects. More... | |
| Q_INVOKABLE bool | rollBack (bool deleteBuffer=true) |
| Stops a current editing operation and discards any uncommitted edits. More... | |
| virtual void | saveStyleToDatabase (const QString &name, const QString &description, bool useAsDefault, const QString &uiFileContent, QString &msgError) |
| Saves named and sld style of the layer to the style table in the db. More... | |
| Q_INVOKABLE void | selectAll () |
| Select all the features. More... | |
| Q_INVOKABLE void | selectByExpression (const QString &expression, QgsVectorLayer::SelectBehavior behavior=QgsVectorLayer::SetSelection) |
| Selects matching features using an expression. More... | |
| Q_INVOKABLE void | selectByIds (const QgsFeatureIds &ids, QgsVectorLayer::SelectBehavior behavior=QgsVectorLayer::SetSelection) |
| Selects matching features using a list of feature IDs. More... | |
| Q_INVOKABLE void | selectByRect (QgsRectangle &rect, QgsVectorLayer::SelectBehavior behavior=QgsVectorLayer::SetSelection) |
| Selects features found within the search rectangle (in layer's coordinates) More... | |
| int | selectedFeatureCount () const |
| Returns the number of features that are selected in this layer. More... | |
| Q_INVOKABLE const QgsFeatureIds & | selectedFeatureIds () const |
| Returns a list of the selected features IDs in this layer. More... | |
| Q_INVOKABLE QgsFeatureList | selectedFeatures () const |
| Returns a copy of the user-selected features. More... | |
| QgsVectorLayerServerProperties * | serverProperties () const |
| Returns QGIS Server Properties of the vector layer. More... | |
| void | setAllowCommit (bool allowCommit) |
| Controls, if the layer is allowed to commit changes. More... | |
| void | setAttributeTableConfig (const QgsAttributeTableConfig &attributeTableConfig) |
| Sets the attribute table configuration object. More... | |
| void | setAuxiliaryLayer (QgsAuxiliaryLayer *layer=nullptr) |
| Sets the current auxiliary layer. More... | |
| void | setConstraintExpression (int index, const QString &expression, const QString &description=QString()) |
| Sets the constraint expression for the specified field index. More... | |
| void | setCoordinateSystem () |
| Setup the coordinate system transformation for the layer. More... | |
| Q_DECL_DEPRECATED void | setDataSource (const QString &dataSource, const QString &baseName, const QString &provider, bool loadDefaultStyleFlag=false) |
| Update the data source of the layer. More... | |
| void | setDataSource (const QString &dataSource, const QString &baseName, const QString &provider, const QgsDataProvider::ProviderOptions &options, bool loadDefaultStyleFlag=false) override |
| Updates the data source of the layer. More... | |
| void | setDefaultValueDefinition (int index, const QgsDefaultValue &definition) |
| Sets the definition of the expression to use when calculating the default value for a field. More... | |
| bool | setDependencies (const QSet< QgsMapLayerDependency > &layers) FINAL |
| Sets the list of dependencies. More... | |
| void | setDiagramLayerSettings (const QgsDiagramLayerSettings &s) |
| void | setDiagramRenderer (QgsDiagramRenderer *r) |
| Sets diagram rendering object (takes ownership) More... | |
| void | setDisplayExpression (const QString &displayExpression) |
| Set the preview expression, used to create a human readable preview string. More... | |
| void | setEditFormConfig (const QgsEditFormConfig &editFormConfig) |
| Sets the editFormConfig (configuration) of the form used to represent this vector layer. More... | |
| void | setEditorWidgetSetup (int index, const QgsEditorWidgetSetup &setup) |
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field at index. More... | |
| Q_DECL_DEPRECATED void | setExcludeAttributesWfs (const QSet< QString > &att) |
| A set of attributes that are not advertised in WFS requests with QGIS server. More... | |
| Q_DECL_DEPRECATED void | setExcludeAttributesWms (const QSet< QString > &att) |
| A set of attributes that are not advertised in WMS requests with QGIS server. More... | |
| void | setFeatureBlendMode (QPainter::CompositionMode blendMode) |
| Sets the blending mode used for rendering each feature. More... | |
| void | setFieldAlias (int index, const QString &aliasString) |
| Sets an alias (a display name) for attributes to display in dialogs. More... | |
| void | setFieldConfigurationFlag (int index, QgsField::ConfigurationFlag flag, bool active) |
| Sets the given configuration flag for the field at given index to be active or not. More... | |
| void | setFieldConfigurationFlags (int index, QgsField::ConfigurationFlags flags) |
| Sets the configuration flags of the field at given index. More... | |
| void | setFieldConstraint (int index, QgsFieldConstraints::Constraint constraint, QgsFieldConstraints::ConstraintStrength strength=QgsFieldConstraints::ConstraintStrengthHard) |
| Sets a constraint for a specified field index. More... | |
| void | setLabeling (QgsAbstractVectorLayerLabeling *labeling) |
| Sets labeling configuration. More... | |
| void | setLabelsEnabled (bool enabled) |
| Sets whether labels should be enabled for the layer. More... | |
| void | setMapTipTemplate (const QString &mapTipTemplate) |
| The mapTip is a pretty, html representation for feature information. More... | |
| void | setOpacity (double opacity) |
| Sets the opacity for the vector layer, where opacity is a value between 0 (totally transparent) and 1.0 (fully opaque). More... | |
| void | setProviderEncoding (const QString &encoding) |
| Sets the text encoding of the data provider. More... | |
| void | setReadExtentFromXml (bool readExtentFromXml) |
| Flag allowing to indicate if the extent has to be read from the XML document when data source has no metadata or if the data provider has to determine it. More... | |
| bool | setReadOnly (bool readonly=true) |
| Makes layer read-only (editing disabled) or not. More... | |
| void | setRenderer (QgsFeatureRenderer *r) |
| Sets renderer which will be invoked to represent this layer. More... | |
| void | setSimplifyMethod (const QgsVectorSimplifyMethod &simplifyMethod) |
| Sets the simplification settings for fast rendering of features. More... | |
| virtual bool | setSubsetString (const QString &subset) |
| Sets the string (typically sql) used to define a subset of the layer. More... | |
| bool | simplifyDrawingCanbeApplied (const QgsRenderContext &renderContext, QgsVectorSimplifyMethod::SimplifyHint simplifyHint) const |
| Returns whether the VectorLayer can apply the specified simplification hint. More... | |
| const QgsVectorSimplifyMethod & | simplifyMethod () const |
| Returns the simplification settings for fast rendering of features. More... | |
| QgsCoordinateReferenceSystem | sourceCrs () const FINAL |
| Returns the coordinate reference system for features in the source. More... | |
| QgsRectangle | sourceExtent () const FINAL |
| Returns the extent of all geometries from the source. More... | |
| QString | sourceName () const FINAL |
| Returns a friendly display name for the source. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | splitFeatures (const QgsCurve *curve, QgsPointSequence &topologyTestPoints, bool preserveCircular=false, bool topologicalEditing=false) |
| Splits features cut by the given curve. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | splitFeatures (const QgsPointSequence &splitLine, bool topologicalEditing=false) |
| Splits features cut by the given line. More... | |
| Q_DECL_DEPRECATED QgsGeometry::OperationResult | splitFeatures (const QVector< QgsPointXY > &splitLine, bool topologicalEditing=false) |
| Splits features cut by the given line. More... | |
| Q_INVOKABLE QgsGeometry::OperationResult | splitParts (const QgsPointSequence &splitLine, bool topologicalEditing=false) |
| Splits parts cut by the given line. More... | |
| Q_DECL_DEPRECATED QgsGeometry::OperationResult | splitParts (const QVector< QgsPointXY > &splitLine, bool topologicalEditing=false) |
| Splits parts cut by the given line. More... | |
| QString | storageType () const |
| Returns the permanent storage type for this layer as a friendly name. More... | |
| QgsStoredExpressionManager * | storedExpressionManager () |
| Returns the manager of the stored expressions for this layer. More... | |
| virtual QString | subsetString () const |
| Returns the string (typically sql) used to define a subset of the layer. More... | |
| QgsFeatureIds | symbolFeatureIds (const QString &legendKey) const |
| Ids of features rendered with specified legend key. More... | |
| QgsMapLayerTemporalProperties * | temporalProperties () override |
| Returns temporal properties associated with the vector layer. More... | |
| Q_INVOKABLE int | translateFeature (QgsFeatureId featureId, double dx, double dy) |
| Translates feature by dx, dy. More... | |
| QStringList | uniqueStringsMatching (int index, const QString &substring, int limit=-1, QgsFeedback *feedback=nullptr) const |
| Returns unique string values of an attribute which contain a specified subset string. More... | |
| QSet< QVariant > | uniqueValues (int fieldIndex, int limit=-1) const FINAL |
| Calculates a list of unique values contained within an attribute in the layer. More... | |
| void | updateExpressionField (int index, const QString &exp) |
| Changes the expression used to define an expression based (virtual) field. More... | |
| bool | updateFeature (QgsFeature &feature, bool skipDefaultValues=false) |
| Updates an existing feature in the layer, replacing the attributes and geometry for the feature with matching QgsFeature::id() with the attributes and geometry from feature. More... | |
| void | updateFields () |
Will regenerate the fields property of this layer by obtaining all fields from the dataProvider, joined fields and virtual fields. More... | |
| const QList< QgsVectorLayerJoinInfo > | vectorJoins () const |
| QList< QgsWeakRelation > | weakRelations () const |
| Returns the layer's weak relations as specified in the layer's style. More... | |
| Q_INVOKABLE QgsWkbTypes::Type | wkbType () const FINAL |
| Returns the WKBType or WKBUnknown in case of error. More... | |
| bool | writeSld (QDomNode &node, QDomDocument &doc, QString &errorMessage, const QgsStringMap &props=QgsStringMap()) const |
| Writes the symbology of the layer into the document provided in SLD 1.1 format. More... | |
| bool | writeStyle (QDomNode &node, QDomDocument &doc, QString &errorMessage, const QgsReadWriteContext &context, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) const FINAL |
| Writes just the style information for the layer into the document. More... | |
| bool | writeSymbology (QDomNode &node, QDomDocument &doc, QString &errorMessage, const QgsReadWriteContext &context, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) const FINAL |
| Writes the symbology for the layer into the document provided. More... | |
| bool | writeXml (QDomNode &layer_node, QDomDocument &doc, const QgsReadWriteContext &context) const FINAL |
| Writes vector layer specific state to project file Dom node. More... | |
| Public Member Functions inherited from QgsMapLayer | |
| QgsMapLayer (QgsMapLayer const &)=delete | |
| QgsMapLayer cannot be copied. More... | |
| QgsMapLayer (QgsMapLayerType type=QgsMapLayerType::VectorLayer, const QString &name=QString(), const QString &source=QString()) | |
| Constructor for QgsMapLayer. More... | |
| ~QgsMapLayer () override | |
| QString | abstract () const |
| Returns the abstract of the layer used by QGIS Server in GetCapabilities request. More... | |
| virtual bool | accept (QgsStyleEntityVisitorInterface *visitor) const |
| Accepts the specified symbology visitor, causing it to visit all symbols associated with the layer. More... | |
| QString | attribution () const |
| Returns the attribution of the layer used by QGIS Server in GetCapabilities request. More... | |
| QString | attributionUrl () const |
| Returns the attribution URL of the layer used by QGIS Server in GetCapabilities request. More... | |
| int | autoRefreshInterval () const |
| Returns the auto refresh interval (in milliseconds). More... | |
| QPainter::CompositionMode | blendMode () const |
| Returns the current blending mode for a layer. More... | |
| QgsCoordinateReferenceSystem | crs () const |
| Returns the layer's spatial reference system. More... | |
| const QgsObjectCustomProperties & | customProperties () const |
| Read all custom properties from layer. More... | |
| Q_INVOKABLE QVariant | customProperty (const QString &value, const QVariant &defaultValue=QVariant()) const |
| Read a custom property from layer. More... | |
| Q_INVOKABLE QStringList | customPropertyKeys () const |
| Returns list of all keys within custom properties. More... | |
| QString | dataUrl () const |
| Returns the DataUrl of the layer used by QGIS Server in GetCapabilities request. More... | |
| QString | dataUrlFormat () const |
| Returns the DataUrl format of the layer used by QGIS Server in GetCapabilities request. More... | |
| virtual QgsError | error () const |
| Gets current status error. More... | |
| void | exportNamedMetadata (QDomDocument &doc, QString &errorMsg) const |
| Export the current metadata of this layer as named metadata in a QDomDocument. More... | |
| virtual void | exportNamedStyle (QDomDocument &doc, QString &errorMsg, const QgsReadWriteContext &context=QgsReadWriteContext(), QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) const |
| Export the properties of this layer as named style in a QDomDocument. More... | |
| virtual void | exportSldStyle (QDomDocument &doc, QString &errorMsg) const |
| Export the properties of this layer as SLD style in a QDomDocument. More... | |
| QgsMapLayer::LayerFlags | flags () const |
| Returns the flags for this layer. More... | |
| bool | hasAutoRefreshEnabled () const |
Returns true if auto refresh is enabled for the layer. More... | |
| bool | hasScaleBasedVisibility () const |
| Returns whether scale based visibility is enabled for the layer. More... | |
| QString | id () const |
| Returns the layer's unique ID, which is used to access this layer from QgsProject. More... | |
| bool | importNamedMetadata (QDomDocument &document, QString &errorMessage) |
| Import the metadata of this layer from a QDomDocument. More... | |
| virtual bool | importNamedStyle (QDomDocument &doc, QString &errorMsg, QgsMapLayer::StyleCategories categories=QgsMapLayer::AllStyleCategories) |
| Import the properties of this layer from a QDomDocument. More... | |
| bool | isInScaleRange (double scale) const |
| Tests whether the layer should be visible at the specified scale. More... | |
| bool | isRefreshOnNotifyEnabled () const |
Returns true if the refresh on provider nofification is enabled. More... | |
| virtual bool | isTemporary () const |
Returns true if the layer is considered a temporary layer. More... | |
| bool | isValid () const |
| Returns the status of the layer. More... | |
| QString | keywordList () const |
| Returns the keyword list of the layer used by QGIS Server in GetCapabilities request. More... | |
| QgsMapLayerLegend * | legend () const |
Can be nullptr. More... | |
| QString | legendUrl () const |
| Returns the URL for the layer's legend. More... | |
| QString | legendUrlFormat () const |
| Returns the format for a URL based layer legend. More... | |
| virtual QString | loadDefaultMetadata (bool &resultFlag) |
| Retrieve the default metadata for this layer if one exists (either as a .qmd file on disk or as a record in the users metadata table in their personal qgis.db) More... | |
| virtual QString | loadNamedMetadata (const QString &uri, bool &resultFlag) |
| Retrieve a named metadata for this layer if one exists (either as a .qmd file on disk or as a record in the users style table in their personal qgis.db) More... | |
| bool | loadNamedMetadataFromDatabase (const QString &db, const QString &uri, QString &qmd) |
| Retrieve a named metadata for this layer from a sqlite database. More... | |
| virtual bool | loadNamedStyleFromDatabase (const QString &db, const QString &uri, QString &qml) |
| Retrieve a named style for this layer from a sqlite database. More... | |
| virtual QString | loadSldStyle (const QString &uri, bool &resultFlag) |
| Attempts to style the layer using the formatting from an SLD type file. More... | |
| double | maximumScale () const |
| Returns the maximum map scale (i.e. More... | |
| virtual const QgsLayerMetadata & | metadata () const |
| Returns a reference to the layer's metadata store. More... | |
| virtual QString | metadataUri () const |
| Retrieve the metadata URI for this layer (either as a .qmd file on disk or as a record in the users style table in their personal qgis.db) More... | |
| QString | metadataUrl () const |
| Returns the metadata URL of the layer used by QGIS Server in GetCapabilities request. More... | |
| QString | metadataUrlFormat () const |
| Returns the metadata format of the layer used by QGIS Server in GetCapabilities request. More... | |
| QString | metadataUrlType () const |
| Returns the metadata type of the layer used by QGIS Server in GetCapabilities request. More... | |
| double | minimumScale () const |
| Returns the minimum map scale (i.e. More... | |
| QString | name () const |
| Returns the display name of the layer. More... | |
| QgsMapLayer & | operator= (QgsMapLayer const &)=delete |
| QgsMapLayer cannot be copied. More... | |
| QString | originalXmlProperties () const |
| Returns the XML properties of the original layer as they were when the layer was first read from the project file. More... | |
| QString | providerType () const |
| Returns the provider type (provider key) for this layer. More... | |
| QString | publicSource () const |
| Gets a version of the internal layer definition that has sensitive bits removed (for example, the password). More... | |
| bool | readLayerXml (const QDomElement &layerElement, QgsReadWriteContext &context, QgsMapLayer::ReadFlags flags=QgsMapLayer::ReadFlags()) |
| Sets state from DOM document. More... | |
| bool | readOnly () const |
| Returns if this layer is read only. More... | |
| virtual bool | readStyle (const QDomNode &node, QString &errorMessage, QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories) |
| Read the style for the current layer from the DOM node supplied. More... | |
| virtual bool | readSymbology (const QDomNode &node, QString &errorMessage, QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories)=0 |
| Read the symbology for the current layer from the DOM node supplied. More... | |
| QString | refreshOnNotifyMessage () const |
| Returns the message that should be notified by the provider to triggerRepaint. More... | |
| void | removeCustomProperty (const QString &key) |
| Remove a custom property from layer. More... | |
| QgsAbstract3DRenderer * | renderer3D () const |
| Returns 3D renderer associated with the layer. More... | |
| virtual QString | saveDefaultMetadata (bool &resultFlag) |
| Save the current metadata of this layer as the default metadata (either as a .qmd file on disk or as a record in the users style table in their personal qgis.db) More... | |
| virtual QString | saveDefaultStyle (bool &resultFlag) |
| Save the properties of this layer as the default style (either as a .qml file on disk or as a record in the users style table in their personal qgis.db) More... | |
| QString | saveNamedMetadata (const QString &uri, bool &resultFlag) |
| Save the current metadata of this layer as a named metadata (either as a .qmd file on disk or as a record in the users style table in their personal qgis.db) More... | |
| virtual QString | saveNamedStyle (const QString &uri, bool &resultFlag, StyleCategories categories=AllStyleCategories) |
| Save the properties of this layer as a named style (either as a .qml file on disk or as a record in the users style table in their personal qgis.db) More... | |
| virtual QString | saveSldStyle (const QString &uri, bool &resultFlag) const |
| Saves the properties of this layer to an SLD format file. More... | |
| void | setAbstract (const QString &abstract) |
| Sets the abstract of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setAttribution (const QString &attrib) |
| Sets the attribution of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setAttributionUrl (const QString &attribUrl) |
| Sets the attribution URL of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setAutoRefreshEnabled (bool enabled) |
| Sets whether auto refresh is enabled for the layer. More... | |
| void | setAutoRefreshInterval (int interval) |
| Sets the auto refresh interval (in milliseconds) for the layer. More... | |
| void | setBlendMode (QPainter::CompositionMode blendMode) |
| Set the blending mode used for rendering a layer. More... | |
| void | setCrs (const QgsCoordinateReferenceSystem &srs, bool emitSignal=true) |
| Sets layer's spatial reference system. More... | |
| void | setCustomProperties (const QgsObjectCustomProperties &properties) |
| Set custom properties for layer. More... | |
| Q_INVOKABLE void | setCustomProperty (const QString &key, const QVariant &value) |
| Set a custom property for layer. More... | |
| void | setDataUrl (const QString &dataUrl) |
| Sets the DataUrl of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setDataUrlFormat (const QString &dataUrlFormat) |
| Sets the DataUrl format of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setFlags (QgsMapLayer::LayerFlags flags) |
| Returns the flags for this layer. More... | |
| void | setKeywordList (const QString &keywords) |
| Sets the keyword list of the layer used by QGIS Server in GetCapabilities request. More... | |
| virtual void | setLayerOrder (const QStringList &layers) |
| Reorders the previously selected sublayers of this layer from bottom to top. More... | |
| void | setLegend (QgsMapLayerLegend *legend) |
| Assign a legend controller to the map layer. More... | |
| void | setLegendUrl (const QString &legendUrl) |
| Sets the URL for the layer's legend. More... | |
| void | setLegendUrlFormat (const QString &legendUrlFormat) |
| Sets the format for a URL based layer legend. More... | |
| virtual void | setMetadata (const QgsLayerMetadata &metadata) |
| Sets the layer's metadata store. More... | |
| void | setMetadataUrl (const QString &metaUrl) |
| Sets the metadata URL of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setMetadataUrlFormat (const QString &metaUrlFormat) |
| Sets the metadata format of the layer used by QGIS Server in GetCapabilities request. More... | |
| void | setMetadataUrlType (const QString &metaUrlType) |
| Set the metadata type of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates the standard to which the metadata complies. More... | |
| void | setName (const QString &name) |
| Set the display name of the layer. More... | |
| void | setOriginalXmlProperties (const QString &originalXmlProperties) |
| Sets the original XML properties for the layer to originalXmlProperties. More... | |
| void | setRenderer3D (QgsAbstract3DRenderer *renderer) |
| Sets 3D renderer for the layer. More... | |
| void | setShortName (const QString &shortName) |
| Sets the short name of the layer used by QGIS Server to identify the layer. More... | |
| virtual void | setSubLayerVisibility (const QString &name, bool visible) |
| Set the visibility of the given sublayer name. More... | |
| void | setTitle (const QString &title) |
| Sets the title of the layer used by QGIS Server in GetCapabilities request. More... | |
| QString | shortName () const |
| Returns the short name of the layer used by QGIS Server to identify the layer. More... | |
| QString | source () const |
| Returns the source for the layer. More... | |
| QgsMapLayerStyleManager * | styleManager () const |
| Gets access to the layer's style manager. More... | |
| virtual QString | styleURI () const |
| Retrieve the style URI for this layer (either as a .qml file on disk or as a record in the users style table in their personal qgis.db) More... | |
| virtual QStringList | subLayers () const |
| Returns the sublayers of this layer. More... | |
| virtual QDateTime | timestamp () const |
| Time stamp of data source in the moment when data/metadata were loaded by provider. More... | |
| QString | title () const |
| Returns the title of the layer used by QGIS Server in GetCapabilities request. More... | |
| QgsCoordinateTransformContext | transformContext () const |
| Returns the layer data provider coordinate transform context or a default transform context if the layer does not have a valid data provider. More... | |
| QgsMapLayerType | type () const |
| Returns the type of the layer. More... | |
| QUndoStack * | undoStack () |
| Returns pointer to layer's undo stack. More... | |
| QUndoStack * | undoStackStyles () |
| Returns pointer to layer's style undo stack. More... | |
| bool | writeLayerXml (QDomElement &layerElement, QDomDocument &document, const QgsReadWriteContext &context) const |
| Stores state in DOM node. More... | |
| virtual bool | writeStyle (QDomNode &node, QDomDocument &doc, QString &errorMessage, const QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories) const |
| Write just the symbology information for the layer into the document. More... | |
| virtual bool | writeSymbology (QDomNode &node, QDomDocument &doc, QString &errorMessage, const QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories) const =0 |
| Write the style for the layer into the docment provided. More... | |
| Public Member Functions inherited from QgsExpressionContextGenerator | |
| virtual | ~QgsExpressionContextGenerator ()=default |
| Public Member Functions inherited from QgsExpressionContextScopeGenerator | |
| virtual | ~QgsExpressionContextScopeGenerator ()=default |
| Public Member Functions inherited from QgsFeatureSink | |
| virtual | ~QgsFeatureSink ()=default |
| virtual bool | addFeatures (QgsFeatureIterator &iterator, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) |
| Adds all features from the specified iterator to the sink. More... | |
| virtual bool | flushBuffer () |
| Flushes any internal buffer which may exist in the sink, causing any buffered features to be added to the sink's destination. More... | |
| virtual QString | lastError () const |
| Returns the most recent error encountered by the sink, e.g. More... | |
| Public Member Functions inherited from QgsFeatureSource | |
| virtual | ~QgsFeatureSource ()=default |
| virtual QgsFeatureIds | allFeatureIds () const |
| Returns a list of all feature IDs for features present in the source. More... | |
| virtual SpatialIndexPresence | hasSpatialIndex () const |
| Returns an enum value representing the presence of a valid spatial index on the source, if it can be determined. More... | |
| QgsVectorLayer * | materialize (const QgsFeatureRequest &request, QgsFeedback *feedback=nullptr) |
| Materializes a request (query) made against this feature source, by running it over the source and returning a new memory based vector layer containing the result. More... | |
Static Public Member Functions | |
| static Q_DECL_DEPRECATED void | drawVertexMarker (double x, double y, QPainter &p, QgsVectorLayer::VertexMarkerType type, int vertexSize) |
| Draws a vertex symbol at (screen) coordinates x, y. More... | |
| Static Public Member Functions inherited from QgsMapLayer | |
| static QString | extensionPropertyType (PropertyType type) |
| Returns the extension of a Property. More... | |
| static QString | formatLayerName (const QString &name) |
| A convenience function to capitalize and format a layer name. More... | |
| static QString | generateId (const QString &layerName) |
| Generates an unique identifier for this layer, the generate ID is prefixed by layerName. More... | |
Protected Member Functions | |
| void | setExtent (const QgsRectangle &rect) FINAL |
| Sets the extent. More... | |
| Protected Member Functions inherited from QgsMapLayer | |
| void | appendError (const QgsErrorMessage &error) |
| Add error message. More... | |
| void | clone (QgsMapLayer *layer) const |
| Copies attributes like name, short name, ... More... | |
| Q_DECL_DEPRECATED bool | hasDependencyCycle (const QSet< QgsMapLayerDependency > &) const |
Checks whether a new set of dependencies will introduce a cycle this method is now deprecated and always return false, because circular dependencies are now correctly managed. More... | |
| void | readCommonStyle (const QDomElement &layerElement, const QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories) |
| Read style data common to all layer types. More... | |
| void | readCustomProperties (const QDomNode &layerNode, const QString &keyStartsWith=QString()) |
| Read custom properties from project file. More... | |
| void | readStyleManager (const QDomNode &layerNode) |
| Read style manager's configuration (if any). To be called by subclasses. More... | |
| void | setError (const QgsError &error) |
| Sets error message. More... | |
| void | setProviderType (const QString &providerType) |
| Sets the providerType (provider key) More... | |
| void | setValid (bool valid) |
| Sets whether layer is valid or not. More... | |
| void | writeCommonStyle (QDomElement &layerElement, QDomDocument &document, const QgsReadWriteContext &context, StyleCategories categories=AllStyleCategories) const |
| Write style data common to all layer types. More... | |
| void | writeCustomProperties (QDomNode &layerNode, QDomDocument &doc) const |
| Write custom properties to project file. More... | |
| void | writeStyleManager (QDomNode &layerNode, QDomDocument &doc) const |
| Write style manager's configuration (if exists). To be called by subclasses. More... | |
Properties | |
| QString | displayExpression |
| QgsEditFormConfig | editFormConfig |
| QString | mapTipTemplate |
| double | opacity |
| bool | readOnly |
| QString | subsetString |
| Properties inherited from QgsMapLayer | |
| int | autoRefreshInterval |
| QgsCoordinateReferenceSystem | crs |
| bool | isValid |
| QgsLayerMetadata | metadata |
| QString | name |
| QgsMapLayerType | type |
Friends | |
| class | QgsVectorLayerEditBuffer |
| class | QgsVectorLayerEditPassthrough |
| class | QgsVectorLayerFeatureSource |
Additional Inherited Members | |
| Protected Attributes inherited from QgsMapLayer | |
| QString | mAbstract |
| Description of the layer. More... | |
| QString | mAttribution |
| Attribution of the layer. More... | |
| QString | mAttributionUrl |
| QString | mDataSource |
| Data source description string, varies by layer type. More... | |
| QString | mDataUrl |
| DataUrl of the layer. More... | |
| QString | mDataUrlFormat |
| QSet< QgsMapLayerDependency > | mDependencies |
| List of layers that may modify this layer on modification. More... | |
| QgsError | mError |
| Error. More... | |
| QgsRectangle | mExtent |
| Extent of the layer. More... | |
| bool | mIsRefreshOnNofifyEnabled = false |
| QString | mKeywordList |
| QString | mLayerName |
| Name of the layer - used for display. More... | |
| QString | mLegendUrl |
| WMS legend. More... | |
| QString | mLegendUrlFormat |
| QString | mMetadataUrl |
| MetadataUrl of the layer. More... | |
| QString | mMetadataUrlFormat |
| QString | mMetadataUrlType |
| QString | mProviderKey |
| Data provider key (name of the data provider) More... | |
| QgsMapLayer::ReadFlags | mReadFlags = QgsMapLayer::ReadFlags() |
| Read flags. It's up to the subclass to respect these when restoring state from XML. More... | |
| QString | mRefreshOnNofifyMessage |
| QString | mShortName |
| bool | mShouldValidateCrs = true |
true if the layer's CRS should be validated and invalid CRSes are not permitted. More... | |
| QString | mTitle |
| bool | mValid = false |
| Indicates if the layer is valid and can be drawn. More... | |
Detailed Description
Represents a vector layer which manages a vector based data sets.
The QgsVectorLayer is instantiated by specifying the name of a data provider, such as postgres or wfs, and url defining the specific data set to connect to. The vector layer constructor in turn instantiates a QgsVectorDataProvider subclass corresponding to the provider type, and passes it the url. The data provider connects to the data source.
The QgsVectorLayer provides a common interface to the different data types. It also manages editing transactions.
Sample usage of the QgsVectorLayer class:
The main data providers supported by QGIS are listed below.
Vector data providers
Memory data providerType (memory)
The memory data provider is used to construct in memory data, for example scratch data or data generated from spatial operations such as contouring. There is no inherent persistent storage of the data. The data source uri is constructed. The url specifies the geometry type ("point", "linestring", "polygon", "multipoint","multilinestring","multipolygon"), optionally followed by url parameters as follows:
- crs=definition Defines the coordinate reference system to use for the layer. definition is any string accepted by QgsCoordinateReferenceSystem::createFromString()
- index=yes Specifies that the layer will be constructed with a spatial index
- field=name:type(length,precision) Defines an attribute of the layer. Multiple field parameters can be added to the data provider definition. type is one of "integer", "double", "string".
An example url is "Point?crs=epsg:4326&field=id:integer&field=name:string(20)&index=yes"
Since QGIS 3.4 when closing a project, the application shows a warning about potential data loss if there are any non-empty memory layers present. If your memory layer should not trigger such warning, it is possible to suppress that by setting the following custom variable:
OGR data provider (ogr)
Accesses data using the OGR drivers (https://gdal.org/drivers/vector/index.html). The url is the OGR connection string. A wide variety of data formats can be accessed using this driver, including file based formats used by many GIS systems, database formats, and web services. Some of these formats are also supported by custom data providers listed below.
SpatiaLite data provider (spatialite)
Access data in a SpatiaLite database. The url defines the connection parameters, table, geometry column, and other attributes. The url can be constructed using the QgsDataSourceUri class.
PostgreSQL data provider (postgres)
Connects to a PostgreSQL database. The url defines the connection parameters, table, geometry column, and other attributes. The url can be constructed using the QgsDataSourceUri class.
Microsoft SQL server data provider (mssql)
Connects to a Microsoft SQL server database. The url defines the connection parameters, table, geometry column, and other attributes. The url can be constructed using the QgsDataSourceUri class.
WFS (web feature service) data provider (wfs)
Used to access data provided by a web feature service.
The url can be a HTTP url to a WFS server (legacy, e.g. http://foobar/wfs?TYPENAME=xxx&SRSNAME=yyy[&FILTER=zzz]), or, starting with QGIS 2.16, a URI constructed using the QgsDataSourceUri class with the following parameters :
- url=string (mandatory): HTTP url to a WFS server endpoint. e.g http://foobar/wfs
- typename=string (mandatory): WFS typename
- srsname=string (recommended): SRS like 'EPSG:XXXX'
- username=string
- password=string
- authcfg=string
- version=auto/1.0.0/1.1.0/2.0.0
- sql=string: full SELECT SQL statement with optional WHERE, ORDER BY and possibly with JOIN if supported on server
- filter=string: QGIS expression or OGC/FES filter
- restrictToRequestBBOX=1: to download only features in the view extent (or more generally in the bounding box of the feature iterator)
- pageSize=number: number of features to retrieve in a single request (WFS 2)
- maxNumFeatures=number: maximum number of features to retrieve (possibly across several multiple paging requests)
- IgnoreAxisOrientation=1: to ignore EPSG axis order for WFS 1.1 or 2.0
- InvertAxisOrientation=1: to invert axis order
- hideDownloadProgressDialog=1: to hide the download progress dialog
The ‘FILTER’ query string parameter can be used to filter the WFS feature type. The ‘FILTER’ key value can either be a QGIS expression or an OGC XML filter. If the value is set to a QGIS expression the driver will turn it into OGC XML filter before passing it to the WFS server. Beware the QGIS expression filter only supports” =, !=, <, >, <=, >=, AND, OR, NOT, LIKE, IS NULL” attribute operators, “BBOX, Disjoint, Intersects, Touches, Crosses, Contains, Overlaps, Within” spatial binary operators and the QGIS local “geomFromWKT, geomFromGML” geometry constructor functions.
OGC API - Features data provider (oapif)
Used to access data provided by a OGC API - Features server.
The URI should be constructed using the QgsDataSourceUri class with the following parameters:
- url=string (mandatory): HTTP url to a OGC API - Features landing page.
- typename=string (mandatory): Collection id
- username=string
- password=string
- authcfg=string
- filter=string: QGIS expression (only datetime filtering is forwarded to the server)
- restrictToRequestBBOX=1: to download only features in the view extent (or more generally in the bounding box of the feature iterator)
- pageSize=number: number of features to retrieve in a single request
- maxNumFeatures=number: maximum number of features to retrieve (possibly across several multiple paging requests)
- hideDownloadProgressDialog=1: to hide the download progress dialog.
Also note:
- You can use various functions available in the QGIS Expression list, however the function must exist server side and have the same name and arguments to work.
- Use the special $geometry parameter to provide the layer geometry column as input into the spatial binary operators e.g intersects($geometry, geomFromWKT('POINT (5 6)'))
Delimited text file data provider (delimitedtext)
Accesses data in a delimited text file, for example CSV files generated by spreadsheets. The contents of the file are split into columns based on specified delimiter characters. Each record may be represented spatially either by an X and Y coordinate column, or by a WKT (well known text) formatted columns.
The url defines the filename, the formatting options (how the text in the file is divided into data fields, and which fields contain the X,Y coordinates or WKT text definition. The options are specified as url query items.
At its simplest the url can just be the filename, in which case it will be loaded as a CSV formatted file.
The url may include the following items:
encoding=UTF-8
Defines the character encoding in the file. The default is UTF-8. To use the default encoding for the operating system use "System".
type=(csv|regexp|whitespace|plain)
Defines the algorithm used to split records into columns. Records are defined by new lines, except for csv format files for which quoted fields may span multiple records. The default type is csv.
- "csv" splits the file based on three sets of characters: delimiter characters, quote characters, and escape characters. Delimiter characters mark the end of a field. Quote characters enclose a field which can contain delimiter characters, and newlines. Escape characters cause the following character to be treated literally (including delimiter, quote, and newline characters). Escape and quote characters must be different from delimiter characters. Escape characters that are also quote characters are treated specially - they can only escape themselves within quotes. Elsewhere they are treated as quote characters. The defaults for delimiter, quote, and escape are ',', '"', '"'.
- "regexp" splits each record using a regular expression (see QRegExp documentation for details).
- "whitespace" splits each record based on whitespace (on or more whitespace characters. Leading whitespace in the record is ignored.
- "plain" is provided for backwards compatibility. It is equivalent to CSV except that the default quote characters are single and double quotes, and there is no escape characters.
delimiter=characters
Defines the delimiter characters used for csv and plain type files, or the regular expression for regexp type files. It is a literal string of characters except that "\t" may be used to represent a tab character.
quote=characters
Defines the characters that are used as quote characters for csv and plain type files.
escape=characters
Defines the characters used to escape delimiter, quote, and newline characters.
skipLines=n
Defines the number of lines to ignore at the beginning of the file (default 0)
useHeader=(yes|no)
Defines whether the first record in the file (after skipped lines) contains column names (default yes)
trimFields=(yes|no)
If yes then leading and trailing whitespace will be removed from fields
skipEmptyFields=(yes|no)
If yes then empty fields will be discarded (equivalent to concatenating consecutive delimiters)
maxFields=#
Specifies the maximum number of fields to load for each record. Additional fields will be discarded. Default is 0 - load all fields.
decimalPoint=c
Defines a character that is used as a decimal point in the numeric columns The default is '.'.
xField=column yField=column
Defines the name of the columns holding the x and y coordinates for XY point geometries. If the useHeader is no (ie there are no column names), then this is the column number (with the first column as 1).
xyDms=(yes|no)
If yes then the X and Y coordinates are interpreted as degrees/minutes/seconds format (fairly permissively), or degree/minutes format.
wktField=column
Defines the name of the columns holding the WKT geometry definition for WKT geometries. If the useHeader is no (ie there are no column names), then this is the column number (with the first column as 1).
geomType=(point|line|polygon|none)
Defines the geometry type for WKT type geometries. QGIS will only display one type of geometry for the layer - any others will be ignored when the file is loaded. By default the provider uses the type of the first geometry in the file. Use geomType to override this type.
geomType can also be set to none, in which case the layer is loaded without geometries.
subset=expression
Defines an expression that will identify a subset of records to display
crs=crsstring
Defines the coordinate reference system used for the layer. This can be any string accepted by QgsCoordinateReferenceSystem::createFromString()
subsetIndex=(yes|no)
Determines whether the provider generates an index to improve the efficiency of subsets. The default is yes
spatialIndex=(yes|no)
Determines whether the provider generates a spatial index. The default is no.
watchFile=(yes|no)
Defines whether the file will be monitored for changes. The default is to monitor for changes.
quiet
Errors encountered loading the file will not be reported in a user dialog if quiet is included (They will still be shown in the output log).
GPX data provider (gpx)
Provider reads tracks, routes, and waypoints from a GPX file. The url defines the name of the file, and the type of data to retrieve from it ("track", "route", or "waypoint").
An example url is "/home/user/data/holiday.gpx?type=route"
Grass data provider (grass)
Provider to display vector data in a GRASS GIS layer.
- See also
- QgsVectorLayerUtils()
Definition at line 386 of file qgsvectorlayer.h.
Member Enumeration Documentation
◆ EditResult
Result of an edit operation.
Definition at line 400 of file qgsvectorlayer.h.
◆ SelectBehavior
Selection behavior.
Definition at line 411 of file qgsvectorlayer.h.
◆ VertexMarkerType
Editing vertex markers.
| Enumerator | |
|---|---|
| SemiTransparentCircle | |
| Cross | |
| NoMarker | |
Definition at line 2020 of file qgsvectorlayer.h.
Constructor & Destructor Documentation
◆ QgsVectorLayer() [1/2]
|
explicit |
Constructor - creates a vector layer.
The QgsVectorLayer is constructed by instantiating a data provider. The provider interprets the supplied path (url) of the data source to connect to and access the data.
- Parameters
-
path The path or url of the parameter. Typically this encodes parameters used by the data provider as url query items. baseName The name used to represent the layer in the legend providerLib The name of the data provider, e.g., "memory", "postgres" options layer load options
Definition at line 147 of file qgsvectorlayer.cpp.
◆ ~QgsVectorLayer()
|
override |
Definition at line 215 of file qgsvectorlayer.cpp.
◆ QgsVectorLayer() [2/2]
|
delete |
QgsVectorLayer cannot be copied.
Member Function Documentation
◆ accept
|
overrideslot |
Definition at line 1501 of file qgsvectorlayer.cpp.
◆ actions() [1/2]
|
inline |
Returns all layer actions defined on this layer.
The pointer which is returned directly points to the actions object which is used by the layer, so any changes are immediately applied.
Definition at line 730 of file qgsvectorlayer.h.
◆ actions() [2/2]
|
inline |
Returns all layer actions defined on this layer.
The pointer which is returned is const.
Definition at line 737 of file qgsvectorlayer.h.
◆ addAttribute()
| bool QgsVectorLayer::addAttribute | ( | const QgsField & | field | ) |
Add an attribute field (but does not commit it) returns true if the field was added.
- Note
- Calls to addAttribute() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 3055 of file qgsvectorlayer.cpp.
◆ addExpressionField()
| int QgsVectorLayer::addExpressionField | ( | const QString & | exp, |
| const QgsField & | fld | ||
| ) |
Add a new field which is calculated by the expression specified.
- Parameters
-
exp The expression which calculates the field fld The field to calculate
- Returns
- The index of the new field
- Since
- QGIS 2.9
Definition at line 3737 of file qgsvectorlayer.cpp.
◆ addFeature()
|
virtual |
Adds a single feature to the sink.
Feature addition behavior is controlled by the specified flags.
- See also
- addFeatures()
- Returns
truein case of success andfalsein case of failure
Reimplemented from QgsFeatureSink.
Definition at line 1011 of file qgsvectorlayer.cpp.
◆ addFeatures()
|
virtual |
Adds a list of features to the sink.
Feature addition behavior is controlled by the specified flags.
- See also
- addFeature()
- Returns
truein case of success andfalsein case of failure
Implements QgsFeatureSink.
Definition at line 3492 of file qgsvectorlayer.cpp.
◆ addJoin()
| bool QgsVectorLayer::addJoin | ( | const QgsVectorLayerJoinInfo & | joinInfo | ) |
Joins another vector layer to this layer.
- Parameters
-
joinInfo join object containing join layer id, target and source field
- Note
- since 2.6 returns bool indicating whether the join can be added
Definition at line 3721 of file qgsvectorlayer.cpp.
◆ addPart() [1/4]
| QgsGeometry::OperationResult QgsVectorLayer::addPart | ( | const QgsPointSequence & | ring | ) |
Adds a new part polygon to a multipart feature.
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Note
- available in Python bindings as addPartV2
- Calls to addPart() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1288 of file qgsvectorlayer.cpp.
◆ addPart() [2/4]
| QgsGeometry::OperationResult QgsVectorLayer::addPart | ( | const QList< QgsPointXY > & | ring | ) |
Adds a new part polygon to a multipart feature.
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Note
- Calls to addPart() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1272 of file qgsvectorlayer.cpp.
◆ addPart() [3/4]
| QgsGeometry::OperationResult QgsVectorLayer::addPart | ( | const QVector< QgsPointXY > & | ring | ) |
Adds a new part polygon to a multipart feature.
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Note
- available in Python bindings as addPartV2
- Calls to addPart() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1283 of file qgsvectorlayer.cpp.
◆ addPart() [4/4]
| QgsGeometry::OperationResult QgsVectorLayer::addPart | ( | QgsCurve * | ring | ) |
- Note
- available in Python as addCurvedPart
- Calls to addPart() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1314 of file qgsvectorlayer.cpp.
◆ addRing() [1/3]
| QgsGeometry::OperationResult QgsVectorLayer::addRing | ( | const QgsPointSequence & | ring, |
| QgsFeatureId * | featureId = nullptr |
||
| ) |
Adds a ring to polygon/multipolygon features.
- Parameters
-
ring ring to add featureId if specified, feature ID for feature ring was added to will be stored in this parameter
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Note
- Calls to addRing() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1211 of file qgsvectorlayer.cpp.
◆ addRing() [2/3]
| QgsGeometry::OperationResult QgsVectorLayer::addRing | ( | const QVector< QgsPointXY > & | ring, |
| QgsFeatureId * | featureId = nullptr |
||
| ) |
Adds a ring to polygon/multipolygon features.
- Parameters
-
ring ring to add featureId if specified, feature ID for feature ring was added to will be stored in this parameter
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Note
- Calls to addRing() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1206 of file qgsvectorlayer.cpp.
◆ addRing() [3/3]
| QgsGeometry::OperationResult QgsVectorLayer::addRing | ( | QgsCurve * | ring, |
| QgsFeatureId * | featureId = nullptr |
||
| ) |
Adds a ring to polygon/multipolygon features (takes ownership)
- Parameters
-
ring ring to add featureId if specified, feature ID for feature ring was added to will be stored in this parameter
- Returns
- QgsGeometry::OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Note
- available in Python as addCurvedRing
- Calls to addRing() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1234 of file qgsvectorlayer.cpp.
◆ addTopologicalPoints() [1/4]
| int QgsVectorLayer::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
- Calls to addTopologicalPoints() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1387 of file qgsvectorlayer.cpp.
◆ addTopologicalPoints() [2/4]
| int QgsVectorLayer::addTopologicalPoints | ( | const QgsPoint & | 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
- Note
- Calls to addTopologicalPoints() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- 3.10
Definition at line 1401 of file qgsvectorlayer.cpp.
◆ addTopologicalPoints() [3/4]
| int QgsVectorLayer::addTopologicalPoints | ( | const QgsPointSequence & | ps | ) |
Adds a vertex to segments which intersect any of the points 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
-
ps point sequence of the vertices
- Returns
- 0 in case of success
- Note
- Calls to addTopologicalPoints() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- 3.16
Definition at line 1410 of file qgsvectorlayer.cpp.
◆ addTopologicalPoints() [4/4]
| int QgsVectorLayer::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
- Note
- Calls to addTopologicalPoints() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1396 of file qgsvectorlayer.cpp.
◆ afterCommitChanges
|
signal |
Emitted after changes are committed to the data provider.
- Since
- QGIS 3.16
◆ afterRollBack
|
signal |
Emitted after changes are rolled back.
- Since
- QGIS 3.4
◆ aggregate()
| QVariant QgsVectorLayer::aggregate | ( | QgsAggregateCalculator::Aggregate | aggregate, |
| const QString & | fieldOrExpression, | ||
| const QgsAggregateCalculator::AggregateParameters & | parameters = QgsAggregateCalculator::AggregateParameters(), |
||
| QgsExpressionContext * | context = nullptr, |
||
| bool * | ok = nullptr, |
||
| QgsFeatureIds * | fids = nullptr |
||
| ) | const |
Calculates an aggregated value from the layer's features.
Currently any filtering expression provided will override filters in the FeatureRequest.
- Parameters
-
aggregate aggregate to calculate fieldOrExpression source field or expression to use as basis for aggregated values. parameters parameters controlling aggregate calculation context expression context for expressions and filters ok if specified, will be set to trueif aggregate calculation was successfulfids list of fids to filter, otherwise will use all fids
- Returns
- calculated aggregate value
- Since
- QGIS 2.16
Definition at line 4287 of file qgsvectorlayer.cpp.
◆ allowCommit()
| bool QgsVectorLayer::allowCommit | ( | ) | const |
Controls, if the layer is allowed to commit changes.
If this is set to false it will not be possible to commit changes on this layer. This can be used to define checks on a layer that need to be pass before the layer can be saved. If you use this API, make sure that:
- the user is visibly informed that his changes were not saved and what he needs to do in order to be able to save the changes.
- to set the property back to
true, once the user has fixed his data.
When calling
- See also
- commitChanges() this flag is checked just after the
- beforeCommitChanges() signal is emitted, so it's possible to adjust it from there.
- Note
- Not available in Python bindings
- Since
- QGIS 3.4
Definition at line 5581 of file qgsvectorlayer.cpp.
◆ allowCommitChanged
|
signal |
Emitted whenever the allowCommitChanged() property of this layer changes.
- Since
- QGIS 3.4
◆ attributeAdded
|
signal |
Will be emitted, when a new attribute has been added to this vector layer.
Applies only to types QgsFields::OriginEdit, QgsFields::OriginProvider and QgsFields::OriginExpression
- Parameters
-
idx The index of the new attribute
- See also
- updatedFields()
◆ attributeAlias()
| QString QgsVectorLayer::attributeAlias | ( | int | index | ) | const |
Returns the alias of an attribute name or a null string if there is no alias.
- See also
- {attributeDisplayName( int attributeIndex )} which returns the field name if no alias is defined.
Definition at line 3131 of file qgsvectorlayer.cpp.
◆ attributeAliases()
| QgsStringMap QgsVectorLayer::attributeAliases | ( | ) | const |
Returns a map of field name to attribute alias.
Definition at line 3147 of file qgsvectorlayer.cpp.
◆ attributeDeleted
|
signal |
Will be emitted, when an attribute has been deleted from this vector layer.
Applies only to types QgsFields::OriginEdit, QgsFields::OriginProvider and QgsFields::OriginExpression
- Parameters
-
idx The index of the deleted attribute
- See also
- updatedFields()
◆ attributeDisplayName()
| QString QgsVectorLayer::attributeDisplayName | ( | int | index | ) | const |
Convenience function that returns the attribute alias if defined or the field name else.
Definition at line 3139 of file qgsvectorlayer.cpp.
◆ attributeList()
|
inline |
Returns list of attribute indexes.
i.e. a list from 0 ... fieldCount()
Definition at line 1704 of file qgsvectorlayer.h.
◆ attributeTableConfig()
| QgsAttributeTableConfig QgsVectorLayer::attributeTableConfig | ( | ) | const |
Returns the attribute table configuration object.
This defines the appearance of the attribute table.
Definition at line 4933 of file qgsvectorlayer.cpp.
◆ attributeValueChanged
|
signal |
Emitted whenever an attribute value change is done in the edit buffer.
Note that at this point the attribute change is not yet saved to the provider.
- Parameters
-
fid The id of the changed feature idx The attribute index of the changed attribute value The new value of the attribute
◆ auxiliaryLayer() [1/2]
| QgsAuxiliaryLayer * QgsVectorLayer::auxiliaryLayer | ( | ) |
Returns the current auxiliary layer.
- Since
- QGIS 3.0
Definition at line 5293 of file qgsvectorlayer.cpp.
◆ auxiliaryLayer() [2/2]
| const QgsAuxiliaryLayer * QgsVectorLayer::auxiliaryLayer | ( | ) | const |
Returns the current const auxiliary layer.
- Since
- QGIS 3.0
Definition at line 5288 of file qgsvectorlayer.cpp.
◆ beforeAddingExpressionField
|
signal |
Will be emitted, when an expression field is going to be added to this vector layer.
Applies only to types QgsFields::OriginExpression
- Parameters
-
fieldName The name of the attribute to be added
◆ beforeCommitChanges
|
signal |
Emitted before changes are committed to the data provider.
The stopEditing flag specifies if the editing mode shall be left after this commit.
◆ beforeEditingStarted
|
signal |
Emitted before editing on this layer is started.
◆ beforeModifiedCheck
|
signal |
Emitted when the layer is checked for modifications. Use for last-minute additions.
◆ beforeRemovingExpressionField
|
signal |
Will be emitted, when an expression field is going to be deleted from this vector layer.
Applies only to types QgsFields::OriginExpression
- Parameters
-
idx The index of the attribute to be deleted
◆ beforeRollBack
|
signal |
Emitted before changes are rolled back.
◆ beginEditCommand()
| void QgsVectorLayer::beginEditCommand | ( | const QString & | text | ) |
Create edit command for undo/redo operations.
- Parameters
-
text text which is to be displayed in undo window
Definition at line 3667 of file qgsvectorlayer.cpp.
◆ boundingBoxOfSelected()
| QgsRectangle QgsVectorLayer::boundingBoxOfSelected | ( | ) | const |
Returns the bounding box of the selected features. If there is no selection, QgsRectangle(0,0,0,0) is returned.
Definition at line 669 of file qgsvectorlayer.cpp.
◆ capabilitiesString()
| QString QgsVectorLayer::capabilitiesString | ( | ) | const |
Capabilities for this layer, comma separated and translated.
Definition at line 350 of file qgsvectorlayer.cpp.
◆ changeAttributeValue()
| bool QgsVectorLayer::changeAttributeValue | ( | QgsFeatureId | fid, |
| int | field, | ||
| const QVariant & | newValue, | ||
| const QVariant & | oldValue = QVariant(), |
||
| bool | skipDefaultValues = false |
||
| ) |
Changes an attribute value for a feature (but does not immediately commit the changes).
The fid argument specifies the ID of the feature to be changed.
The field argument must specify a valid field index for the layer (where an index of 0 corresponds to the first field).
The new value to be assigned to the field is given by newValue.
If a valid QVariant is specified for oldValue, it will be used as the field value in the case of an undo operation corresponding to this attribute value change. If an invalid QVariant is used (the default behavior), then the feature's current value will be automatically retrieved and used. Note that this involves a feature request to the underlying data provider, so it is more efficient to explicitly pass an oldValue if it is already available.
If skipDefaultValues is set to true, default field values will not be updated. This can be used to override default field value expressions.
- Returns
trueif the feature's attribute was successfully changed.
- Note
- Calls to changeAttributeValue() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 2966 of file qgsvectorlayer.cpp.
◆ changeAttributeValues()
| bool QgsVectorLayer::changeAttributeValues | ( | QgsFeatureId | fid, |
| const QgsAttributeMap & | newValues, | ||
| const QgsAttributeMap & | oldValues = QgsAttributeMap(), |
||
| bool | skipDefaultValues = false |
||
| ) |
Changes attributes' values for a feature (but does not immediately commit the changes).
The fid argument specifies the ID of the feature to be changed.
The new values to be assigned to the fields are given by newValues.
If a valid QVariant is specified for a field in oldValues, it will be used as the field value in the case of an undo operation corresponding to this attribute value change. If an invalid QVariant is used (the default behavior), then the feature's current value will be automatically retrieved and used. Note that this involves a feature request to the underlying data provider, so it is more efficient to explicitly pass an oldValue if it is already available.
If skipDefaultValues is set to true, default field values will not be updated. This can be used to override default field value expressions.
- Returns
trueif feature's attributes was successfully changed.
- Note
- Calls to changeAttributeValues() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- QGIS 3.0
Definition at line 2997 of file qgsvectorlayer.cpp.
◆ changeGeometry()
| bool QgsVectorLayer::changeGeometry | ( | QgsFeatureId | fid, |
| QgsGeometry & | geometry, | ||
| bool | skipDefaultValue = false |
||
| ) |
Changes a feature's geometry within the layer's edit buffer (but does not immediately commit the changes).
The fid argument specifies the ID of the feature to be changed.
If skipDefaultValue is set to true, default field values will not be updated. This can be used to override default field value expressions.
- Returns
trueif the feature's geometry was successfully changed.
- Note
- Calls to changeGeometry() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 2942 of file qgsvectorlayer.cpp.
◆ clone()
|
overridevirtual |
Returns a new instance equivalent to this one.
A new provider is created for the same data source and renderers for features and diagrams are cloned too. Moreover, each attributes (transparency, extent, selected features and so on) are identicals.
- Returns
- a new layer instance
- Since
- QGIS 3.0
Implements QgsMapLayer.
Definition at line 239 of file qgsvectorlayer.cpp.
◆ commitChanges()
| bool QgsVectorLayer::commitChanges | ( | bool | stopEditing = true | ) |
Attempts to commit to the underlying data provider any buffered changes made since the last to call to startEditing().
Returns the result of the attempt. If a commit fails (i.e. false is returned), the in-memory changes are left untouched and are not discarded. 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 can be difficult to roll back cleanly. Therefore any error message returned by commitErrors() also includes which stage failed so that the user has some chance of repairing the damage cleanly.
By setting stopEditing to false, the layer will stay in editing mode. Otherwise the layer editing mode will be disabled if the commit is successful.
- See also
- startEditing()
- commitErrors()
- rollBack()
Definition at line 3332 of file qgsvectorlayer.cpp.
◆ commitErrors()
| QStringList QgsVectorLayer::commitErrors | ( | ) | const |
Returns a list containing any error messages generated when attempting to commit changes to the layer.
- See also
- commitChanges()
Definition at line 3382 of file qgsvectorlayer.cpp.
◆ committedAttributesAdded
|
signal |
Emitted when attributes are added to the provider.
◆ committedAttributesDeleted
|
signal |
Emitted when attributes are deleted from the provider.
◆ committedAttributeValuesChanges
|
signal |
Emitted when attribute value changes are saved to the provider.
◆ committedFeaturesAdded
|
signal |
Emitted when features are added to the provider.
◆ committedFeaturesRemoved
|
signal |
Emitted when features are deleted from the provider.
◆ committedGeometriesChanges
|
signal |
Emitted when geometry changes are saved to the provider.
◆ conditionalStyles()
| QgsConditionalLayerStyles * QgsVectorLayer::conditionalStyles | ( | ) | const |
Returns the conditional styles that are set for this layer.
Style information is used to render conditional formatting in the attribute table.
- Returns
- Return a QgsConditionalLayerStyles object holding the conditional attribute style information. Style information is generic and can be used for anything.
- Since
- QGIS 2.12
Definition at line 988 of file qgsvectorlayer.cpp.
◆ constraintDescription()
| QString QgsVectorLayer::constraintDescription | ( | int | index | ) | const |
Returns the descriptive name for the constraint expression for a specified field index.
- Since
- QGIS 3.0
Definition at line 5483 of file qgsvectorlayer.cpp.
◆ constraintExpression()
| QString QgsVectorLayer::constraintExpression | ( | int | index | ) | const |
Returns the constraint expression for for a specified field index, if set.
- Since
- QGIS 3.0
Definition at line 5475 of file qgsvectorlayer.cpp.
◆ countSymbolFeatures()
| QgsVectorLayerFeatureCounter * QgsVectorLayer::countSymbolFeatures | ( | bool | storeSymbolFids = false | ) |
Count features for symbols.
The method will return the feature counter task. You will need to connect to the symbolFeatureCountMapChanged() signal to be notified when the freshly updated feature counts are ready.
- Parameters
-
storeSymbolFids If truewill gather the feature ids (fids) per symbol, otherwise only the count. Defaultfalse.
- Note
- If the count features for symbols has been already done a
nullptris returned. If you need to wait for the results, you can call waitForFinished() on the feature counter.
- Since
- This is asynchronous since QGIS 3.0
Definition at line 766 of file qgsvectorlayer.cpp.
◆ createExpressionContext()
|
virtual |
This method needs to be reimplemented in all classes which implement this interface and return an expression context.
- Since
- QGIS 3.0
Implements QgsExpressionContextGenerator.
Definition at line 4952 of file qgsvectorlayer.cpp.
◆ createExpressionContextScope()
|
virtual |
This method needs to be reimplemented in all classes which implement this interface and return an expression context scope.
- Since
- QGIS 3.0
Implements QgsExpressionContextScopeGenerator.
Definition at line 4957 of file qgsvectorlayer.cpp.
◆ createMapRenderer()
|
virtual |
Returns new instance of QgsMapLayerRenderer that will be used for rendering of given context.
- Since
- QGIS 2.4
Implements QgsMapLayer.
Definition at line 387 of file qgsvectorlayer.cpp.
◆ dataComment()
| QString QgsVectorLayer::dataComment | ( | ) | const |
Returns a description for this layer as defined in the data provider.
Definition at line 359 of file qgsvectorlayer.cpp.
◆ dataProvider() [1/2]
|
virtual |
Returns the layer's data provider in a const-correct manner, it may be nullptr.
- Note
- not available in Python bindings
Reimplemented from QgsMapLayer.
Definition at line 632 of file qgsvectorlayer.cpp.
◆ dataProvider() [2/2]
|
virtual |
Returns the layer's data provider, it may be nullptr.
Reimplemented from QgsMapLayer.
Definition at line 627 of file qgsvectorlayer.cpp.
◆ decodedSource()
|
virtual |
Called by readLayerXML(), used by derived classes to decode provider's specific data source from project files.
Typically resolving absolute or relative paths, usernames and passwords or drivers prefixes ("HDF5:")
- Parameters
-
source data source to decode, typically read from layer's DOM element "datasource" dataProvider string identification of data provider (e.g. "ogr"), typically read from layer's DOM element context reading context (e.g. for conversion between relative and absolute paths)
- Returns
- decoded source, typically to be used as the layer's datasource
- Since
- QGIS 3.2
Reimplemented from QgsMapLayer.
Definition at line 2019 of file qgsvectorlayer.cpp.
◆ defaultValue()
| QVariant QgsVectorLayer::defaultValue | ( | int | index, |
| const QgsFeature & | feature = QgsFeature(), |
||
| QgsExpressionContext * | context = nullptr |
||
| ) | const |
Returns the calculated default value for the specified field index.
The default value may be taken from a client side default value expression (see setDefaultValueDefinition()) or taken from the underlying data provider.
- Parameters
-
index field index feature optional feature to use for default value evaluation. If passed, then properties from the feature (such as geometry) can be used when calculating the default value. context optional expression context to evaluate expressions again. If not specified, a default context will be created
- Returns
- calculated default value
- See also
- setDefaultValueDefinition()
- Since
- QGIS 3.0
Definition at line 3898 of file qgsvectorlayer.cpp.
◆ defaultValueDefinition()
| QgsDefaultValue QgsVectorLayer::defaultValueDefinition | ( | int | index | ) | const |
Returns the definition of the expression used when calculating the default value for a field.
- Parameters
-
index field index
- Returns
- definition of the default value with the expression evaluated when calculating default values for field, or definition with an empty string if no default is set
- Since
- QGIS 3.0
Definition at line 3960 of file qgsvectorlayer.cpp.
◆ deleteAttribute()
|
virtual |
Deletes an attribute field (but does not commit it).
- Note
- Calls to deleteAttribute() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Reimplemented in QgsAuxiliaryLayer.
Definition at line 3152 of file qgsvectorlayer.cpp.
◆ deleteAttributes()
| bool QgsVectorLayer::deleteAttributes | ( | const QList< int > & | attrs | ) |
Deletes a list of attribute fields (but does not commit it)
- Parameters
-
attrs the indices of the attributes to delete
- Returns
trueif at least one attribute has been deleted
Definition at line 3169 of file qgsvectorlayer.cpp.
◆ deleteFeature()
| bool QgsVectorLayer::deleteFeature | ( | QgsFeatureId | fid, |
| QgsVectorLayer::DeleteContext * | context = nullptr |
||
| ) |
Deletes a feature from the layer (but does not commit it).
- Parameters
-
fid The feature id to delete context The chain of features who will be deleted for feedback and to avoid endless recursions
- Note
- Calls to deleteFeature() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 3251 of file qgsvectorlayer.cpp.
◆ deleteFeatures()
| bool QgsVectorLayer::deleteFeatures | ( | const QgsFeatureIds & | fids, |
| QgsVectorLayer::DeleteContext * | context = nullptr |
||
| ) |
Deletes a set of features from the layer (but does not commit it)
- Parameters
-
fids The feature ids to delete context The chain of features who will be deleted for feedback and to avoid endless recursions
- Returns
falseif the layer is not in edit mode or does not support deleting in case of an active transaction depends on the provider implementation
- Note
- Calls to deleteFeatures() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 3267 of file qgsvectorlayer.cpp.
◆ deleteSelectedFeatures()
| bool QgsVectorLayer::deleteSelectedFeatures | ( | int * | deletedCount = nullptr, |
| QgsVectorLayer::DeleteContext * | context = nullptr |
||
| ) |
Deletes the selected features.
- Parameters
-
deletedCount The number of successfully deleted features context The chain of features who will be deleted for feedback and to avoid endless recursions
- Returns
truein case of success andfalseotherwise
Definition at line 1161 of file qgsvectorlayer.cpp.
◆ deleteStyleFromDatabase()
|
virtual |
Deletes a style from the database.
- Parameters
-
styleId the provider's layer_styles table id of the style to delete msgError will be set to a descriptive error message if any occurs
- Returns
truein case of success
- Since
- QGIS 3.0
Definition at line 5197 of file qgsvectorlayer.cpp.
◆ deleteVertex()
| QgsVectorLayer::EditResult QgsVectorLayer::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
- Note
- Calls to deleteVertex() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- QGIS 2.14
Definition at line 1147 of file qgsvectorlayer.cpp.
◆ dependencies()
|
virtual |
Gets the list of dependencies.
This includes data dependencies set by the user (
- See also
- setDataDependencies) as well as dependencies given by the provider
- Returns
- a set of QgsMapLayerDependency
- Since
- QGIS 3.0
Reimplemented from QgsMapLayer.
Definition at line 5325 of file qgsvectorlayer.cpp.
◆ deselect [1/2]
|
slot |
Deselects features by their ID.
- Parameters
-
featureIds The ids of the features to deselect
- See also
- deselect(const QgsFeatureId)
Definition at line 433 of file qgsvectorlayer.cpp.
◆ deselect [2/2]
|
slot |
Deselects feature by its ID.
- Parameters
-
featureId The id of the feature to deselect
- See also
- deselect(const QgsFeatureIds&)
Definition at line 425 of file qgsvectorlayer.cpp.
◆ destroyEditCommand()
| void QgsVectorLayer::destroyEditCommand | ( | ) |
Destroy active command and reverts all changes in it.
Definition at line 3699 of file qgsvectorlayer.cpp.
◆ diagramLayerSettings()
|
inline |
Definition at line 889 of file qgsvectorlayer.h.
◆ diagramRenderer()
|
inline |
Definition at line 886 of file qgsvectorlayer.h.
◆ diagramsEnabled()
| bool QgsVectorLayer::diagramsEnabled | ( | ) | const |
Returns whether the layer contains diagrams which are enabled and should be drawn.
- Returns
trueif layer contains enabled diagrams
- Since
- QGIS 2.9
Definition at line 738 of file qgsvectorlayer.cpp.
◆ displayExpression()
| QString QgsVectorLayer::displayExpression | ( | ) | const |
Returns the preview expression, used to create a human readable preview string.
Uses QgsExpression
- Returns
- The expression which will be used to preview features for this layer
Definition at line 3542 of file qgsvectorlayer.cpp.
◆ displayExpressionChanged
|
signal |
Emitted when the display expression changes.
- Since
- QGIS 3.0
◆ displayField()
| QString QgsVectorLayer::displayField | ( | ) | const |
This is a shorthand for accessing the displayExpression if it is a simple field.
If the displayExpression is more complex than a simple field, a null string will be returned.
- See also
- displayExpression
Definition at line 3522 of file qgsvectorlayer.cpp.
◆ drawVertexMarker()
|
static |
Draws a vertex symbol at (screen) coordinates x, y.
(Useful to assist vertex editing.)
- Deprecated:
- Use the equivalent QgsSymbolLayerUtils::drawVertexMarker function instead
Definition at line 393 of file qgsvectorlayer.cpp.
◆ editBuffer() [1/2]
|
inline |
Buffer with uncommitted editing operations. Only valid after editing has been turned on.
Definition at line 1999 of file qgsvectorlayer.h.
◆ editBuffer() [2/2]
|
inline |
Buffer with uncommitted editing operations.
Only valid after editing has been turned on.
- Note
- not available in Python bindings
Definition at line 2005 of file qgsvectorlayer.h.
◆ editCommandDestroyed
|
signal |
Signal emitted, when an edit command is destroyed.
- Note
- This is not a rollback, it is only related to the current edit command. See beforeRollBack()
◆ editCommandEnded
|
signal |
Signal emitted, when an edit command successfully ended.
- Note
- This does not mean it is also committed, only that it is written to the edit buffer. See beforeCommitChanges()
◆ editCommandStarted
|
signal |
Signal emitted when a new edit command has been started.
- Parameters
-
text Description for this edit command
◆ editFormConfig()
| QgsEditFormConfig QgsVectorLayer::editFormConfig | ( | ) | const |
Returns the configuration of the form used to represent this vector layer.
- Returns
- The configuration of this layers' form
- Since
- QGIS 2.14
Definition at line 4904 of file qgsvectorlayer.cpp.
◆ editFormConfigChanged
|
signal |
Will be emitted whenever the edit form configuration of this layer changes.
- Since
- QGIS 3.0
◆ editingStarted
|
signal |
Emitted when editing on this layer has started.
◆ editingStopped
|
signal |
Emitted when edited changes have been successfully written to the data provider.
◆ editorWidgetSetup()
| QgsEditorWidgetSetup QgsVectorLayer::editorWidgetSetup | ( | int | index | ) | const |
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field at index.
- Since
- QGIS 3.0
Definition at line 5546 of file qgsvectorlayer.cpp.
◆ encodedSource()
|
virtual |
Called by writeLayerXML(), used by derived classes to encode provider's specific data source to project files.
Typically resolving absolute or relative paths, usernames and passwords or drivers prefixes ("HDF5:")
- Parameters
-
source data source to encode, typically QgsMapLayer::source() context writing context (e.g. for conversion between relative and absolute paths)
- Returns
- encoded source, typically to be written in the DOM element "datasource"
- Since
- QGIS 3.2
Reimplemented from QgsMapLayer.
Definition at line 1934 of file qgsvectorlayer.cpp.
◆ endEditCommand()
| void QgsVectorLayer::endEditCommand | ( | ) |
Finish edit command and add it to undo/redo stack.
Definition at line 3683 of file qgsvectorlayer.cpp.
◆ excludeAttributesWfs()
|
inline |
A set of attributes that are not advertised in WFS requests with QGIS server.
- Deprecated:
- since QGIS 3.16, use fields().configurationFlags() instead
Definition at line 1882 of file qgsvectorlayer.h.
◆ excludeAttributesWms()
|
inline |
A set of attributes that are not advertised in WMS requests with QGIS server.
- Deprecated:
- since QGIS 3.16, use fields().configurationFlags() instead
Definition at line 1870 of file qgsvectorlayer.h.
◆ expressionField()
| QString QgsVectorLayer::expressionField | ( | int | index | ) | const |
Returns the expression used for a given expression field.
- Parameters
-
index An index of an epxression based (virtual) field
- Returns
- The expression for the field at index
- Since
- QGIS 2.9
Definition at line 3756 of file qgsvectorlayer.cpp.
◆ extent()
|
virtual |
Returns the extent of the layer.
Reimplemented from QgsMapLayer.
Definition at line 833 of file qgsvectorlayer.cpp.
◆ featureAdded
|
signal |
Emitted when a new feature has been added to the layer.
- Parameters
-
fid The id of the new feature
◆ featureBlendMode()
| QPainter::CompositionMode QgsVectorLayer::featureBlendMode | ( | ) | const |
Returns the current blending mode for features.
Definition at line 4338 of file qgsvectorlayer.cpp.
◆ featureBlendModeChanged
|
signal |
Signal emitted when setFeatureBlendMode() is called.
◆ featureCount() [1/2]
|
virtual |
Returns feature count including changes which have not yet been committed If you need only the count of committed features call this method on this layer's provider.
- Returns
- the number of features on this layer or -1 if unknown.
Implements QgsFeatureSource.
Definition at line 3305 of file qgsvectorlayer.cpp.
◆ featureCount() [2/2]
| long QgsVectorLayer::featureCount | ( | const QString & | legendKey | ) | const |
Number of features rendered with specified legend key.
Features must be first calculated by countSymbolFeatures()
- Returns
- number of features rendered by symbol or -1 if failed or counts are not available
Definition at line 751 of file qgsvectorlayer.cpp.
◆ featureDeleted
|
signal |
Emitted when a feature has been deleted.
If you do expensive operations in a slot connected to this, you should prefer to use featuresDeleted( const QgsFeatureIds& ).
- Parameters
-
fid The id of the feature which has been deleted
◆ featuresDeleted
|
signal |
Emitted when features have been deleted.
If features are deleted within an edit command, this will only be emitted once at the end to allow connected slots to minimize the overhead. If features are deleted outside of an edit command, this signal will be emitted once per feature.
- Parameters
-
fids The feature ids that have been deleted.
◆ fieldConfigurationFlags()
| QgsField::ConfigurationFlags QgsVectorLayer::fieldConfigurationFlags | ( | int | index | ) | const |
Returns the configuration flags of the field at given index.
- See also
- QgsField::ConfigurationFlag
- Since
- QGIS 3.16
Definition at line 5525 of file qgsvectorlayer.cpp.
◆ fieldConstraints()
| QgsFieldConstraints::Constraints QgsVectorLayer::fieldConstraints | ( | int | fieldIndex | ) | const |
Returns any constraints which are present for a specified field index.
These constraints may be inherited from the layer's data provider or may be set manually on the vector layer from within QGIS.
- See also
- setFieldConstraint()
- Since
- QGIS 3.0
Definition at line 5404 of file qgsvectorlayer.cpp.
◆ fieldConstraintsAndStrength()
| QMap< QgsFieldConstraints::Constraint, QgsFieldConstraints::ConstraintStrength > QgsVectorLayer::fieldConstraintsAndStrength | ( | int | fieldIndex | ) | const |
Returns a map of constraint with their strength for a specific field of the layer.
- Parameters
-
fieldIndex field index
- Since
- QGIS 3.0
Definition at line 5420 of file qgsvectorlayer.cpp.
◆ fields()
|
virtual |
Returns the list of fields of this layer.
This also includes fields which have not yet been saved to the provider.
- Returns
- A list of fields
Implements QgsFeatureSource.
Definition at line 3283 of file qgsvectorlayer.cpp.
◆ geometryChanged
|
signal |
Emitted whenever a geometry change is done in the edit buffer.
Note that at this point the geometry change is not yet saved to the provider.
- Parameters
-
fid The id of the changed feature geometry The new geometry
◆ geometryOptions()
| QgsGeometryOptions * QgsVectorLayer::geometryOptions | ( | ) | const |
Configuration and logic to apply automatically on any edit happening on this layer.
- Since
- QGIS 3.4
Definition at line 5595 of file qgsvectorlayer.cpp.
◆ geometryType()
| QgsWkbTypes::GeometryType QgsVectorLayer::geometryType | ( | ) | const |
Returns point, line or polygon.
Definition at line 659 of file qgsvectorlayer.cpp.
◆ getFeature()
|
inline |
Queries the layer for the feature with the given id.
If there is no such feature, the returned feature will be invalid.
Definition at line 1194 of file qgsvectorlayer.h.
◆ getFeatures() [1/4]
|
inline |
Queries the layer for the features with the given ids.
Definition at line 1210 of file qgsvectorlayer.h.
◆ getFeatures() [2/4]
|
virtual |
Queries the layer for features specified in request.
- Parameters
-
request feature request describing parameters of features to return
- Returns
- iterator for matching features from provider
Implements QgsFeatureSource.
Definition at line 993 of file qgsvectorlayer.cpp.
◆ getFeatures() [3/4]
|
inline |
Queries the layer for the features which intersect the specified rectangle.
Definition at line 1218 of file qgsvectorlayer.h.
◆ getFeatures() [4/4]
|
inline |
Queries the layer for features matching a given expression.
Definition at line 1185 of file qgsvectorlayer.h.
◆ getGeometry()
| QgsGeometry QgsVectorLayer::getGeometry | ( | QgsFeatureId | fid | ) | const |
Queries the layer for the geometry at the given id.
If there is no such feature, the returned geometry will be invalid.
Definition at line 1001 of file qgsvectorlayer.cpp.
◆ getSelectedFeatures()
| QgsFeatureIterator QgsVectorLayer::getSelectedFeatures | ( | QgsFeatureRequest | request = QgsFeatureRequest() | ) | const |
Returns an iterator of the selected features.
- Parameters
-
request You may specify a request, e.g. to limit the set of requested attributes. Any filter on the request will be discarded.
- Returns
- Iterator over the selected features
- Warning
- Calling this method returns an iterator for all attributes and geometry for the selected features. Consider using the much more efficient selectedFeatureIds() or selectedFeatureCount() if you do not require access to the feature attributes or geometry.
Definition at line 3476 of file qgsvectorlayer.cpp.
◆ getStyleFromDatabase()
|
virtual |
Returns the named style corresponding to style id provided.
Definition at line 5192 of file qgsvectorlayer.cpp.
◆ hasFeatures()
|
virtual |
Determines if this vector layer has features.
- Warning
- when a layer is editable and some features have been deleted, this will return QgsFeatureSource::FeatureAvailability::FeaturesMayBeAvailable to avoid a potentially expensive call to the dataprovider.
- Since
- QGIS 3.4
Reimplemented from QgsFeatureSource.
Definition at line 3313 of file qgsvectorlayer.cpp.
◆ hasSpatialIndex
|
overrideslot |
Definition at line 1496 of file qgsvectorlayer.cpp.
◆ htmlMetadata()
|
virtual |
Obtain a formatted HTML string containing assorted metadata for this layer.
- Since
- QGIS 3.0
Reimplemented from QgsMapLayer.
Definition at line 4969 of file qgsvectorlayer.cpp.
◆ insertVertex() [1/2]
| bool QgsVectorLayer::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
- Note
- Calls to insertVertex() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1108 of file qgsvectorlayer.cpp.
◆ insertVertex() [2/2]
| bool QgsVectorLayer::insertVertex | ( | double | x, |
| double | y, | ||
| 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
- Note
- Calls to insertVertex() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1095 of file qgsvectorlayer.cpp.
◆ invertSelection()
| void QgsVectorLayer::invertSelection | ( | ) |
Selects not selected features and deselects selected ones.
Definition at line 568 of file qgsvectorlayer.cpp.
◆ invertSelectionInRectangle()
| void QgsVectorLayer::invertSelectionInRectangle | ( | QgsRectangle & | rect | ) |
Inverts selection of features found within the search rectangle (in layer's coordinates)
- Parameters
-
rect The rectangle in which the selection of features will be inverted
- See also
- invertSelection()
Definition at line 580 of file qgsvectorlayer.cpp.
◆ isAuxiliaryField()
| bool QgsVectorLayer::isAuxiliaryField | ( | int | index, |
| int & | srcIndex | ||
| ) | const |
Returns true if the field comes from the auxiliary layer, false otherwise.
- Since
- QGIS 3.0
Definition at line 3627 of file qgsvectorlayer.cpp.
◆ isEditable()
|
virtual |
Returns true if the provider is in editing mode.
Reimplemented from QgsMapLayer.
Definition at line 3594 of file qgsvectorlayer.cpp.
◆ isEditCommandActive()
|
inline |
◆ isModified()
|
virtual |
Returns true if the provider has been modified since the last commit.
Definition at line 3621 of file qgsvectorlayer.cpp.
◆ isSpatial()
|
virtual |
Returns true if this is a geometry layer and false in case of NoGeometry (table only) or UnknownGeometry.
Reimplemented from QgsMapLayer.
Definition at line 3599 of file qgsvectorlayer.cpp.
◆ joinBuffer() [1/2]
|
inline |
◆ joinBuffer() [2/2]
|
inline |
Returns a const pointer on join buffer object.
- Since
- QGIS 3.10
Definition at line 658 of file qgsvectorlayer.h.
◆ labeling() [1/2]
|
inline |
Access to labeling configuration.
May be nullptr if labeling is not used.
- Note
- Labels will only be rendered if labelsEnabled() returns
true.
- See also
- labelsEnabled()
- Since
- QGIS 3.0
Definition at line 1656 of file qgsvectorlayer.h.
◆ labeling() [2/2]
|
inline |
Access to const labeling configuration.
May be nullptr if labeling is not used.
- Note
- Labels will only be rendered if labelsEnabled() returns
true.
- See also
- labelsEnabled()
- Since
- QGIS 3.0
Definition at line 1648 of file qgsvectorlayer.h.
◆ labelingFontNotFound
|
signal |
Emitted when the font family defined for labeling layer is not found on system.
◆ labelsEnabled()
| bool QgsVectorLayer::labelsEnabled | ( | ) | const |
Returns whether the layer contains labels which are enabled and should be drawn.
- Returns
trueif layer contains enabled labels
- See also
- setLabelsEnabled()
- Since
- QGIS 2.9
Definition at line 728 of file qgsvectorlayer.cpp.
◆ layerModified
|
signal |
Emitted when modifications has been done on layer.
◆ listStylesInDatabase()
|
virtual |
Lists all the style in db split into related to the layer and not related to.
- Parameters
-
ids the list in which will be stored the style db ids names the list in which will be stored the style names descriptions the list in which will be stored the style descriptions msgError will be set to a descriptive error message if any occurs
- Returns
- the number of styles related to current layer (-1 on not implemented)
- Note
- Since QGIS 3.2 Styles related to the layer are ordered with the default style first then by update time for Postgres, MySQL and Spatialite.
Definition at line 5187 of file qgsvectorlayer.cpp.
◆ loadAuxiliaryLayer()
| bool QgsVectorLayer::loadAuxiliaryLayer | ( | const QgsAuxiliaryStorage & | storage, |
| const QString & | key = QString() |
||
| ) |
Loads the auxiliary layer for this vector layer.
If there's no corresponding table in the database, then nothing happens and false is returned. The key is optional because if this layer has been read from a XML document, then the key read in this document is used by default.
- Parameters
-
storage The auxiliary storage where to look for the table key The key to use for joining.
- Returns
trueif the auxiliary layer is well loaded,falseotherwise
- Since
- QGIS 3.0
Definition at line 5236 of file qgsvectorlayer.cpp.
◆ loadDefaultStyle()
|
virtual |
Retrieve the default style for this layer if one exists (either as a .qml file on disk or as a record in the users style table in their personal qgis.db)
- Parameters
-
resultFlag a reference to a flag that will be set to falseif we did not manage to load the default style.
- Returns
- a QString with any status messages
- See also
- also loadNamedStyle();
Reimplemented from QgsMapLayer.
Definition at line 1715 of file qgsvectorlayer.cpp.
◆ loadNamedStyle() [1/2]
|
virtual |
Loads a named style from file/local db/datasource db.
- Parameters
-
theURI the URI of the style or the URI of the layer resultFlag will be set to trueif a named style is correctly loadedloadFromLocalDb if trueforces to load from local db instead of datasource onecategories the style categories to be loaded.
Definition at line 5298 of file qgsvectorlayer.cpp.
◆ loadNamedStyle() [2/2]
|
virtual |
Calls loadNamedStyle( theURI, resultFlag, false ); Retained for backward compatibility.
Reimplemented from QgsMapLayer.
Definition at line 5231 of file qgsvectorlayer.cpp.
◆ mapTipTemplate()
| QString QgsVectorLayer::mapTipTemplate | ( | ) | const |
The mapTip is a pretty, html representation for feature information.
It may also contain embedded expressions.
- Since
- QGIS 3.0
Definition at line 4919 of file qgsvectorlayer.cpp.
◆ mapTipTemplateChanged
|
signal |
Emitted when the map tip changes.
- Since
- QGIS 3.0
◆ maximumValue()
|
virtual |
Returns the maximum value for an attribute column or an invalid variant in case of error.
Note that in some circumstances when unsaved changes are present for the layer then the returned value may be outdated (for instance when the attribute value in a saved feature has been changed inside the edit buffer then the previous saved value may be returned as the maximum).
- See also
- minimumValue()
- uniqueValues()
Reimplemented from QgsFeatureSource.
Definition at line 4181 of file qgsvectorlayer.cpp.
◆ minimumValue()
|
virtual |
Returns the minimum value for an attribute column or an invalid variant in case of error.
Note that in some circumstances when unsaved changes are present for the layer then the returned value may be outdated (for instance when the attribute value in a saved feature has been changed inside the edit buffer then the previous saved value may be returned as the minimum).
- See also
- maximumValue()
- uniqueValues()
Reimplemented from QgsFeatureSource.
Definition at line 4176 of file qgsvectorlayer.cpp.
◆ modifySelection()
| void QgsVectorLayer::modifySelection | ( | const QgsFeatureIds & | selectIds, |
| const QgsFeatureIds & | deselectIds | ||
| ) |
Modifies the current selection on this layer.
- Parameters
-
selectIds Select these ids deselectIds Deselect these ids
- See also
- selectByIds
- deselect(const QgsFeatureIds&)
- deselect(const QgsFeatureId)
- selectByExpression()
Definition at line 553 of file qgsvectorlayer.cpp.
◆ moveVertex() [1/2]
| bool QgsVectorLayer::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 as moveVertexV2
- Calls to moveVertex() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1134 of file qgsvectorlayer.cpp.
◆ moveVertex() [2/2]
| bool QgsVectorLayer::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.
- Note
- Calls to moveVertex() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1121 of file qgsvectorlayer.cpp.
◆ opacity()
| double QgsVectorLayer::opacity | ( | ) | const |
Returns the opacity for the vector layer, where opacity is a value between 0 (totally transparent) and 1.0 (fully opaque).
- See also
- setOpacity()
- opacityChanged()
- Since
- QGIS 3.0
Definition at line 4352 of file qgsvectorlayer.cpp.
◆ opacityChanged
|
signal |
Emitted when the layer's opacity is changed, where opacity is a value between 0 (transparent) and 1 (opaque).
- See also
- setOpacity()
- opacity()
- Since
- QGIS 3.0
◆ operator=()
|
delete |
QgsVectorLayer cannot be copied.
◆ primaryKeyAttributes()
| QgsAttributeList QgsVectorLayer::primaryKeyAttributes | ( | ) | const |
Returns the list of attributes which make up the layer's primary keys.
Definition at line 3288 of file qgsvectorlayer.cpp.
◆ raiseError
|
signal |
Signals an error related to this vector layer.
◆ readCustomSymbology
|
signal |
Signal emitted whenever the symbology (QML-file) for this layer is being read.
If there is custom style information saved in the file, you can connect to this signal and update the layer style accordingly.
- Parameters
-
element The XML layer style element. errorMessage Write error messages into this string.
◆ readExtentFromXml()
| bool QgsVectorLayer::readExtentFromXml | ( | ) | const |
Returns true if the extent is read from the XML document when data source has no metadata, false if it's the data provider which determines it.
- Since
- QGIS 3.0
Definition at line 5605 of file qgsvectorlayer.cpp.
◆ readOnlyChanged
|
signal |
Emitted when the read only state of this layer is changed.
Only applies to manually set readonly state, not to the edit mode.
- Since
- QGIS 3.0
◆ readSld()
|
virtual |
Reimplemented from QgsMapLayer.
Definition at line 2881 of file qgsvectorlayer.cpp.
◆ readStyle()
| bool QgsVectorLayer::readStyle | ( | const QDomNode & | node, |
| QString & | errorMessage, | ||
| QgsReadWriteContext & | context, | ||
| QgsMapLayer::StyleCategories | categories = QgsMapLayer::AllStyleCategories |
||
| ) |
Reads the style for the current layer from the Dom node supplied.
- Parameters
-
node node that will contain the style definition for this layer. errorMessage reference to string that will be updated with any error messages context reading context (used for transform from relative to absolute paths) categories the style categories to be read
- Returns
truein case of success.
Definition at line 2411 of file qgsvectorlayer.cpp.
◆ readSymbology()
| bool QgsVectorLayer::readSymbology | ( | const QDomNode & | layerNode, |
| QString & | errorMessage, | ||
| QgsReadWriteContext & | context, | ||
| QgsMapLayer::StyleCategories | categories = QgsMapLayer::AllStyleCategories |
||
| ) |
Reads the symbology for the current layer from the Dom node supplied.
- Parameters
-
layerNode node that will contain the symbology definition for this layer. errorMessage reference to string that will be updated with any error messages context reading context (used for transform from relative to absolute paths) categories the style categories to be read
- Returns
truein case of success.
Definition at line 2123 of file qgsvectorlayer.cpp.
◆ readXml()
|
virtual |
Reads vector layer specific state from project file Dom node.
- Note
- Called by QgsMapLayer::readXml().
Reimplemented from QgsMapLayer.
Definition at line 1514 of file qgsvectorlayer.cpp.
◆ referencingRelations()
| QList< QgsRelation > QgsVectorLayer::referencingRelations | ( | int | idx | ) | const |
Returns the layer's relations, where the foreign key is on this layer.
- Parameters
-
idx Only get relations, where idx forms part of the foreign key
- Returns
- A list of relations
Definition at line 5177 of file qgsvectorlayer.cpp.
◆ reload()
|
virtual |
Synchronises with changes in the datasource.
Reimplemented from QgsMapLayer.
Definition at line 378 of file qgsvectorlayer.cpp.
◆ removeExpressionField()
| void QgsVectorLayer::removeExpressionField | ( | int | index | ) |
Removes an expression field.
- Parameters
-
index The index of the field
- Since
- QGIS 2.6
Definition at line 3747 of file qgsvectorlayer.cpp.
◆ removeFieldAlias()
| void QgsVectorLayer::removeFieldAlias | ( | int | index | ) |
Removes an alias (a display name) for attributes to display in dialogs.
- Since
- QGIS 3.0
Definition at line 3063 of file qgsvectorlayer.cpp.
◆ removeFieldConstraint()
| void QgsVectorLayer::removeFieldConstraint | ( | int | index, |
| QgsFieldConstraints::Constraint | constraint | ||
| ) |
Removes a constraint for a specified field index.
Any constraints inherited from the layer's data provider will be kept intact and cannot be removed.
- Since
- QGIS 3.0
Definition at line 5458 of file qgsvectorlayer.cpp.
◆ removeJoin()
| bool QgsVectorLayer::removeJoin | ( | const QString & | joinLayerId | ) |
Removes a vector layer join.
- Returns
trueif join was found and successfully removed
Definition at line 3727 of file qgsvectorlayer.cpp.
◆ removeSelection
|
slot |
Clear selection.
- See also
- selectByIds()
- reselect()
Definition at line 609 of file qgsvectorlayer.cpp.
◆ renameAttribute()
| bool QgsVectorLayer::renameAttribute | ( | int | index, |
| const QString & | newName | ||
| ) |
Renames an attribute field (but does not commit it).
- Parameters
-
index attribute index newName new name of field
- Note
- Calls to renameAttribute() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- QGIS 2.16
Definition at line 3079 of file qgsvectorlayer.cpp.
◆ renderer() [1/2]
|
inline |
Returns renderer.
Definition at line 892 of file qgsvectorlayer.h.
◆ renderer() [2/2]
|
inline |
Returns const renderer.
- Note
- not available in Python bindings
Definition at line 898 of file qgsvectorlayer.h.
◆ reselect
|
slot |
Reselects the previous set of selected features.
This is only applicable after a prior call to removeSelection().
Any other modifications to the selection following a call to removeSelection() clears memory of the previous selection and consequently calling reselect() has no impact.
- See also
- removeSelection()
- Since
- QGIS 3.10
Definition at line 619 of file qgsvectorlayer.cpp.
◆ resolveReferences()
|
virtual |
Resolves references to other layers (kept as layer IDs after reading XML) into layer objects.
- Since
- QGIS 3.0
Reimplemented from QgsMapLayer.
Definition at line 2116 of file qgsvectorlayer.cpp.
◆ rollBack()
| bool QgsVectorLayer::rollBack | ( | bool | deleteBuffer = true | ) |
Stops a current editing operation and discards any uncommitted edits.
If deleteBuffer is true the editing buffer will be completely deleted (the default behavior).
- See also
- startEditing()
- commitChanges()
Definition at line 3387 of file qgsvectorlayer.cpp.
◆ saveStyleToDatabase()
|
virtual |
Saves named and sld style of the layer to the style table in the db.
- Parameters
-
name Style name description A description of the style useAsDefault Set to trueif style should be used as the default style for the layeruiFileContent msgError will be set to a descriptive error message if any occurs
Definition at line 5203 of file qgsvectorlayer.cpp.
◆ select [1/2]
|
slot |
Selects features by their ID.
- Parameters
-
featureIds The ids of the features to select
- See also
- select(QgsFeatureId)
Definition at line 417 of file qgsvectorlayer.cpp.
◆ select [2/2]
|
slot |
Selects feature by its ID.
- Parameters
-
featureId The id of the feature to select
- See also
- select( const QgsFeatureIds& )
Definition at line 409 of file qgsvectorlayer.cpp.
◆ selectAll()
| void QgsVectorLayer::selectAll | ( | ) |
Select all the features.
Definition at line 575 of file qgsvectorlayer.cpp.
◆ selectByExpression()
| void QgsVectorLayer::selectByExpression | ( | const QString & | expression, |
| QgsVectorLayer::SelectBehavior | behavior = QgsVectorLayer::SetSelection |
||
| ) |
Selects matching features using an expression.
- Parameters
-
expression expression to evaluate to select features behavior selection type, allows adding to current selection, removing from selection, etc.
- See also
- selectByRect()
- selectByIds()
- Since
- QGIS 2.16
Definition at line 463 of file qgsvectorlayer.cpp.
◆ selectByIds()
| void QgsVectorLayer::selectByIds | ( | const QgsFeatureIds & | ids, |
| QgsVectorLayer::SelectBehavior | behavior = QgsVectorLayer::SetSelection |
||
| ) |
Selects matching features using a list of feature IDs.
Will emit the selectionChanged() signal with the clearAndSelect flag set.
- Parameters
-
ids feature IDs to select behavior selection type, allows adding to current selection, removing from selection, etc.
- See also
- selectByRect()
- selectByExpression()
- Since
- QGIS 2.16
Definition at line 523 of file qgsvectorlayer.cpp.
◆ selectByRect()
| void QgsVectorLayer::selectByRect | ( | QgsRectangle & | rect, |
| QgsVectorLayer::SelectBehavior | behavior = QgsVectorLayer::SetSelection |
||
| ) |
Selects features found within the search rectangle (in layer's coordinates)
- Parameters
-
rect search rectangle behavior selection type, allows adding to current selection, removing from selection, etc.
Definition at line 441 of file qgsvectorlayer.cpp.
◆ selectedFeatureCount()
| int QgsVectorLayer::selectedFeatureCount | ( | ) | const |
Returns the number of features that are selected in this layer.
- See also
- selectedFeatureIds()
Definition at line 3436 of file qgsvectorlayer.cpp.
◆ selectedFeatureIds()
| const QgsFeatureIds & QgsVectorLayer::selectedFeatureIds | ( | ) | const |
Returns a list of the selected features IDs in this layer.
Definition at line 3441 of file qgsvectorlayer.cpp.
◆ selectedFeatures()
| QgsFeatureList QgsVectorLayer::selectedFeatures | ( | ) | const |
Returns a copy of the user-selected features.
- Warning
- Calling this method triggers a request for all attributes and geometry for the selected features. Consider using the much more efficient selectedFeatureIds() or selectedFeatureCount() if you do not require access to the feature attributes or geometry.
- Returns
- A list of QgsFeature
- See also
- selectedFeatureIds()
- getSelectedFeatures() which is more memory friendly when handling large selections
Definition at line 3446 of file qgsvectorlayer.cpp.
◆ selectionChanged
|
signal |
Emitted when selection was changed.
- Parameters
-
selected Newly selected feature ids deselected Ids of all features which have previously been selected but are not any more clearAndSelect In case this is set to true, the old selection was dismissed and the new selection corresponds to selected
◆ serverProperties()
|
inline |
Returns QGIS Server Properties of the vector layer.
- Since
- QGIS 3.10
Definition at line 743 of file qgsvectorlayer.h.
◆ setAllowCommit()
| void QgsVectorLayer::setAllowCommit | ( | bool | allowCommit | ) |
Controls, if the layer is allowed to commit changes.
If this is set to false it will not be possible to commit changes on this layer. This can be used to define checks on a layer that need to be pass before the layer can be saved. If you use this API, make sure that:
- the user is visibly informed that his changes were not saved and what he needs to do in order to be able to save the changes.
- to set the property back to
true, once the user has fixed his data.
When calling
- See also
- commitChanges() this flag is checked just after the
- beforeCommitChanges() signal is emitted, so it's possible to adjust it from there.
- Note
- Not available in Python bindings
- Since
- QGIS 3.4
Definition at line 5586 of file qgsvectorlayer.cpp.
◆ setAttributeTableConfig()
| void QgsVectorLayer::setAttributeTableConfig | ( | const QgsAttributeTableConfig & | attributeTableConfig | ) |
Sets the attribute table configuration object.
This defines the appearance of the attribute table.
Definition at line 4943 of file qgsvectorlayer.cpp.
◆ setAuxiliaryLayer()
| void QgsVectorLayer::setAuxiliaryLayer | ( | QgsAuxiliaryLayer * | layer = nullptr | ) |
Sets the current auxiliary layer.
The auxiliary layer is automatically put in editable mode and fields are updated. Moreover, a join is created between the current layer and the auxiliary layer. Ownership is transferred.
- Since
- QGIS 3.0
Definition at line 5265 of file qgsvectorlayer.cpp.
◆ setConstraintExpression()
| void QgsVectorLayer::setConstraintExpression | ( | int | index, |
| const QString & | expression, | ||
| const QString & | description = QString() |
||
| ) |
Sets the constraint expression for the specified field index.
An optional descriptive name for the constraint can also be set. Setting an empty expression will clear any existing expression constraint.
- Since
- QGIS 3.0
Definition at line 5491 of file qgsvectorlayer.cpp.
◆ setCoordinateSystem()
| void QgsVectorLayer::setCoordinateSystem | ( | ) |
Setup the coordinate system transformation for the layer.
Definition at line 3516 of file qgsvectorlayer.cpp.
◆ setDataSource() [1/2]
| void QgsVectorLayer::setDataSource | ( | const QString & | dataSource, |
| const QString & | baseName, | ||
| const QString & | provider, | ||
| bool | loadDefaultStyleFlag = false |
||
| ) |
Update the data source of the layer.
The layer's renderer and legend will be preserved only if the geometry type of the new data source matches the current geometry type of the layer.
- Parameters
-
dataSource new layer data source baseName base name of the layer provider provider string loadDefaultStyleFlag set to trueto reset the layer's style to the default for the data source
- Since
- QGIS 2.10
- Deprecated:
- Use version with ProviderOptions argument instead
Definition at line 1630 of file qgsvectorlayer.cpp.
◆ setDataSource() [2/2]
|
overridevirtual |
Updates the data source of the layer.
The layer's renderer and legend will be preserved only if the geometry type of the new data source matches the current geometry type of the layer.
- Parameters
-
dataSource new layer data source baseName base name of the layer provider provider string options provider options loadDefaultStyleFlag set to trueto reset the layer's style to the default for the data source
- See also
- dataSourceChanged()
- Since
- QGIS 3.2
Reimplemented from QgsMapLayer.
Definition at line 1636 of file qgsvectorlayer.cpp.
◆ setDefaultValueDefinition()
| void QgsVectorLayer::setDefaultValueDefinition | ( | int | index, |
| const QgsDefaultValue & | definition | ||
| ) |
Sets the definition of the expression to use when calculating the default value for a field.
- Parameters
-
index field index definition default value definition to use and evaluate when calculating default values for field. Pass an empty expression to clear the default.
- Since
- QGIS 3.0
Definition at line 3944 of file qgsvectorlayer.cpp.
◆ setDependencies()
|
virtual |
Sets the list of dependencies.
- See also
- dependencies()
- Parameters
-
layers set of QgsMapLayerDependency. Only user-defined dependencies will be added
- Returns
falseif a dependency cycle has been detected
- Since
- QGIS 3.0
Reimplemented from QgsMapLayer.
Definition at line 5350 of file qgsvectorlayer.cpp.
◆ setDiagramLayerSettings()
| void QgsVectorLayer::setDiagramLayerSettings | ( | const QgsDiagramLayerSettings & | s | ) |
Definition at line 4962 of file qgsvectorlayer.cpp.
◆ setDiagramRenderer()
| void QgsVectorLayer::setDiagramRenderer | ( | QgsDiagramRenderer * | r | ) |
Sets diagram rendering object (takes ownership)
Definition at line 651 of file qgsvectorlayer.cpp.
◆ setDisplayExpression()
| void QgsVectorLayer::setDisplayExpression | ( | const QString & | displayExpression | ) |
Set the preview expression, used to create a human readable preview string.
Used e.g. in the attribute table feature list. Uses QgsExpression.
- Parameters
-
displayExpression The expression which will be used to preview features for this layer
Definition at line 3533 of file qgsvectorlayer.cpp.
◆ setEditFormConfig()
| void QgsVectorLayer::setEditFormConfig | ( | const QgsEditFormConfig & | editFormConfig | ) |
Sets the editFormConfig (configuration) of the form used to represent this vector layer.
- See also
- editFormConfig()
- Since
- QGIS 3.0
Definition at line 4909 of file qgsvectorlayer.cpp.
◆ setEditorWidgetSetup()
| void QgsVectorLayer::setEditorWidgetSetup | ( | int | index, |
| const QgsEditorWidgetSetup & | setup | ||
| ) |
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field at index.
- Since
- QGIS 3.0
Definition at line 5534 of file qgsvectorlayer.cpp.
◆ setExcludeAttributesWfs()
|
inline |
A set of attributes that are not advertised in WFS requests with QGIS server.
- Deprecated:
- since QGIS 3.16, use setFieldConfigurationFlag instead
Definition at line 1888 of file qgsvectorlayer.h.
◆ setExcludeAttributesWms()
|
inline |
A set of attributes that are not advertised in WMS requests with QGIS server.
- Deprecated:
- since QGIS 3.16, use setFieldConfigurationFlag instead
Definition at line 1876 of file qgsvectorlayer.h.
◆ setExtent()
|
protectedvirtual |
◆ setFeatureBlendMode()
| void QgsVectorLayer::setFeatureBlendMode | ( | QPainter::CompositionMode | blendMode | ) |
Sets the blending mode used for rendering each feature.
Definition at line 4328 of file qgsvectorlayer.cpp.
◆ setFieldAlias()
| void QgsVectorLayer::setFieldAlias | ( | int | index, |
| const QString & | aliasString | ||
| ) |
Sets an alias (a display name) for attributes to display in dialogs.
- Since
- QGIS 3.0
Definition at line 3118 of file qgsvectorlayer.cpp.
◆ setFieldConfigurationFlag()
| void QgsVectorLayer::setFieldConfigurationFlag | ( | int | index, |
| QgsField::ConfigurationFlag | flag, | ||
| bool | active | ||
| ) |
Sets the given configuration flag for the field at given index to be active or not.
- Since
- QGIS 3.16
Definition at line 5516 of file qgsvectorlayer.cpp.
◆ setFieldConfigurationFlags()
| void QgsVectorLayer::setFieldConfigurationFlags | ( | int | index, |
| QgsField::ConfigurationFlags | flags | ||
| ) |
Sets the configuration flags of the field at given index.
- See also
- QgsField::ConfigurationFlag
- Since
- QGIS 3.16
Definition at line 5507 of file qgsvectorlayer.cpp.
◆ setFieldConstraint()
| void QgsVectorLayer::setFieldConstraint | ( | int | index, |
| QgsFieldConstraints::Constraint | constraint, | ||
| QgsFieldConstraints::ConstraintStrength | strength = QgsFieldConstraints::ConstraintStrengthHard |
||
| ) |
Sets a constraint for a specified field index.
Any constraints inherited from the layer's data provider will be kept intact and cannot be modified. Ie, calling this method only allows for new constraints to be added on top of the existing provider constraints.
- Since
- QGIS 3.0
Definition at line 5441 of file qgsvectorlayer.cpp.
◆ setLabeling()
| void QgsVectorLayer::setLabeling | ( | QgsAbstractVectorLayerLabeling * | labeling | ) |
Sets labeling configuration.
Takes ownership of the object.
- Since
- QGIS 3.0
Definition at line 1419 of file qgsvectorlayer.cpp.
◆ setLabelsEnabled()
| void QgsVectorLayer::setLabelsEnabled | ( | bool | enabled | ) |
Sets whether labels should be enabled for the layer.
- Note
- Labels will only be rendered if labelsEnabled() is
trueand a labeling object is returned by labeling().
- See also
- labelsEnabled()
- labeling()
Definition at line 733 of file qgsvectorlayer.cpp.
◆ setMapTipTemplate()
| void QgsVectorLayer::setMapTipTemplate | ( | const QString & | mapTipTemplate | ) |
The mapTip is a pretty, html representation for feature information.
It may also contain embedded expressions.
- Since
- QGIS 3.0
Definition at line 4924 of file qgsvectorlayer.cpp.
◆ setOpacity()
| void QgsVectorLayer::setOpacity | ( | double | opacity | ) |
Sets the opacity for the vector layer, where opacity is a value between 0 (totally transparent) and 1.0 (fully opaque).
- See also
- opacity()
- opacityChanged()
- Since
- QGIS 3.0
Definition at line 4343 of file qgsvectorlayer.cpp.
◆ setProviderEncoding()
| void QgsVectorLayer::setProviderEncoding | ( | const QString & | encoding | ) |
Sets the text encoding of the data provider.
An empty encoding string indicates that the provider should automatically select the most appropriate encoding.
- Warning
- Support for setting the provider encoding depends on the underlying data provider. Check dataProvider().capabilities() for the QgsVectorDataProvider::SelectEncoding capability in order to determine if the provider supports this ability.
Definition at line 642 of file qgsvectorlayer.cpp.
◆ setReadExtentFromXml()
| void QgsVectorLayer::setReadExtentFromXml | ( | bool | readExtentFromXml | ) |
Flag allowing to indicate if the extent has to be read from the XML document when data source has no metadata or if the data provider has to determine it.
- Since
- QGIS 3.0
Definition at line 5600 of file qgsvectorlayer.cpp.
◆ setReadOnly()
| bool QgsVectorLayer::setReadOnly | ( | bool | readonly = true | ) |
Makes layer read-only (editing disabled) or not.
- Returns
falseif the layer is in editing yet
Definition at line 3610 of file qgsvectorlayer.cpp.
◆ setRenderer()
| void QgsVectorLayer::setRenderer | ( | QgsFeatureRenderer * | r | ) |
Sets renderer which will be invoked to represent this layer.
Ownership is transferred.
Definition at line 3646 of file qgsvectorlayer.cpp.
◆ setSimplifyMethod()
|
inline |
Sets the simplification settings for fast rendering of features.
- Since
- QGIS 2.2
Definition at line 2278 of file qgsvectorlayer.h.
◆ setSubsetString()
|
virtual |
Sets the string (typically sql) used to define a subset of the layer.
- Parameters
-
subset The subset string. This may be the where clause of a sql statement or other definition string specific to the underlying dataprovider and data store.
- Returns
true, when setting the subset string was successful,falseotherwise
Definition at line 943 of file qgsvectorlayer.cpp.
◆ setTransformContext
|
overridevirtualslot |
Sets the coordinate transform context to transformContext.
- Since
- QGIS 3.8
Definition at line 1490 of file qgsvectorlayer.cpp.
◆ simplifyDrawingCanbeApplied()
| bool QgsVectorLayer::simplifyDrawingCanbeApplied | ( | const QgsRenderContext & | renderContext, |
| QgsVectorSimplifyMethod::SimplifyHint | simplifyHint | ||
| ) | const |
Returns whether the VectorLayer can apply the specified simplification hint.
- Note
- Do not use in 3rd party code - may be removed in future version!
- Since
- QGIS 2.2
Definition at line 976 of file qgsvectorlayer.cpp.
◆ simplifyMethod()
|
inline |
Returns the simplification settings for fast rendering of features.
- Since
- QGIS 2.2
Definition at line 2284 of file qgsvectorlayer.h.
◆ sourceCrs()
|
virtual |
Returns the coordinate reference system for features in the source.
Implements QgsFeatureSource.
Definition at line 368 of file qgsvectorlayer.cpp.
◆ sourceExtent()
|
virtual |
Returns the extent of all geometries from the source.
The base class implementation uses a non-optimised approach of looping through all features in the source.
Reimplemented from QgsFeatureSource.
Definition at line 928 of file qgsvectorlayer.cpp.
◆ sourceName()
|
virtual |
Returns a friendly display name for the source.
The returned value can be an empty string.
Implements QgsFeatureSource.
Definition at line 373 of file qgsvectorlayer.cpp.
◆ splitFeatures() [1/3]
| QgsGeometry::OperationResult QgsVectorLayer::splitFeatures | ( | const QgsCurve * | curve, |
| QgsPointSequence & | topologyTestPoints, | ||
| bool | preserveCircular = false, |
||
| bool | topologicalEditing = false |
||
| ) |
Splits features cut by the given curve.
- Parameters
-
curve curve that splits the layer features [out] topologyTestPoints topological points to be tested against other layers preserveCircular whether circular strings are preserved after splitting topologicalEditing trueif topological editing is enabled
- Returns
- QgsGeometry::OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Note
- Calls to splitFeatures() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Since
- QGIS 3.16
Definition at line 1378 of file qgsvectorlayer.cpp.
◆ splitFeatures() [2/3]
| QgsGeometry::OperationResult QgsVectorLayer::splitFeatures | ( | const QgsPointSequence & | splitLine, |
| bool | topologicalEditing = false |
||
| ) |
Splits features cut by the given line.
- Parameters
-
splitLine line that splits the layer features topologicalEditing trueif topological editing is enabled
- Returns
- QgsGeometry::OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Note
- Calls to splitFeatures() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1370 of file qgsvectorlayer.cpp.
◆ splitFeatures() [3/3]
| QgsGeometry::OperationResult QgsVectorLayer::splitFeatures | ( | const QVector< QgsPointXY > & | splitLine, |
| bool | topologicalEditing = false |
||
| ) |
Splits features cut by the given line.
- Parameters
-
splitLine line that splits the layer features topologicalEditing trueif topological editing is enabled
- Returns
- QgsGeometry::OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Note
- Calls to splitFeatures() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1365 of file qgsvectorlayer.cpp.
◆ splitParts() [1/2]
| QgsGeometry::OperationResult QgsVectorLayer::splitParts | ( | const QgsPointSequence & | splitLine, |
| bool | topologicalEditing = false |
||
| ) |
Splits parts cut by the given line.
- Parameters
-
splitLine line that splits the layer features topologicalEditing trueif topological editing is enabled
- Returns
- QgsGeometry::OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Note
- Calls to splitParts() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1357 of file qgsvectorlayer.cpp.
◆ splitParts() [2/2]
| QgsGeometry::OperationResult QgsVectorLayer::splitParts | ( | const QVector< QgsPointXY > & | splitLine, |
| bool | topologicalEditing = false |
||
| ) |
Splits parts cut by the given line.
- Parameters
-
splitLine line that splits the layer features topologicalEditing trueif topological editing is enabled
- Returns
- QgsGeometry::OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Note
- Calls to splitParts() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Deprecated:
- since QGIS 3.12 - will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
Definition at line 1353 of file qgsvectorlayer.cpp.
◆ startEditing
|
slot |
Makes the layer editable.
This starts an edit session on this layer. Changes made in this edit session will not be made persistent until commitChanges() is called, and can be reverted by calling rollBack().
- Returns
trueif the layer was successfully made editable, orfalseif the operation failed (e.g. due to an underlying read-only data source, or lack of edit support by the backend data provider).
- See also
- commitChanges()
- rollBack()
Definition at line 1428 of file qgsvectorlayer.cpp.
◆ storageType()
| QString QgsVectorLayer::storageType | ( | ) | const |
Returns the permanent storage type for this layer as a friendly name.
This is obtained from the data provider and does not follow any standard.
Definition at line 340 of file qgsvectorlayer.cpp.
◆ storedExpressionManager()
|
inline |
Returns the manager of the stored expressions for this layer.
- Since
- QGIS 3.10
Definition at line 2428 of file qgsvectorlayer.h.
◆ subsetString()
|
virtual |
Returns the string (typically sql) used to define a subset of the layer.
- Returns
- The subset string or null QString if not implemented by the provider
Definition at line 933 of file qgsvectorlayer.cpp.
◆ subsetStringChanged
|
signal |
Emitted when the layer's subset string has changed.
- Since
- QGIS 3.2
◆ symbolFeatureCountMapChanged
|
signal |
Emitted when the feature count for symbols on this layer has been recalculated.
- Since
- QGIS 3.0
◆ symbolFeatureIds()
| QgsFeatureIds QgsVectorLayer::symbolFeatureIds | ( | const QString & | legendKey | ) | const |
Ids of features rendered with specified legend key.
Features must be first calculated by countSymbolFeatures()
- Returns
- Ids of features rendered by symbol or -1 if failed or Ids are not available
- Since
- QGIS 3.10
Definition at line 759 of file qgsvectorlayer.cpp.
◆ temporalProperties()
|
overridevirtual |
Returns temporal properties associated with the vector layer.
Reimplemented from QgsMapLayer.
Definition at line 637 of file qgsvectorlayer.cpp.
◆ translateFeature()
| int QgsVectorLayer::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
- Note
- Calls to translateFeature() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
Definition at line 1340 of file qgsvectorlayer.cpp.
◆ uniqueStringsMatching()
| QStringList QgsVectorLayer::uniqueStringsMatching | ( | int | index, |
| const QString & | substring, | ||
| int | limit = -1, |
||
| QgsFeedback * | feedback = nullptr |
||
| ) | const |
Returns unique string values of an attribute which contain a specified subset string.
Subset matching is done in a case-insensitive manner. Note that in some circumstances when unsaved changes are present for the layer then the returned list may contain outdated values (for instance when the attribute value in a saved feature has been changed inside the edit buffer then the previous saved value will be included in the returned list).
- Parameters
-
index column index for attribute substring substring to match (case insensitive) limit maxmum number of the values to return, or -1 to return all unique values feedback optional feedback object for canceling request
- Returns
- list of unique strings containing substring
Definition at line 4075 of file qgsvectorlayer.cpp.
◆ uniqueValues()
|
virtual |
Calculates a list of unique values contained within an attribute in the layer.
Note that in some circumstances when unsaved changes are present for the layer then the returned list may contain outdated values (for instance when the attribute value in a saved feature has been changed inside the edit buffer then the previous saved value will be included in the returned list).
- Parameters
-
fieldIndex column index for attribute limit maximum number of values to return (or -1 if unlimited)
- See also
- minimumValue()
- maximumValue()
Reimplemented from QgsFeatureSource.
Definition at line 3968 of file qgsvectorlayer.cpp.
◆ updatedFields
|
signal |
Emitted whenever the fields available from this layer have been changed.
This can be due to manually adding attributes or due to a join.
◆ updateExpressionField()
| void QgsVectorLayer::updateExpressionField | ( | int | index, |
| const QString & | exp | ||
| ) |
Changes the expression used to define an expression based (virtual) field.
- Parameters
-
index The index of the expression to change exp The new expression to set
- Since
- QGIS 2.9
Definition at line 3765 of file qgsvectorlayer.cpp.
◆ updateExtents
|
virtualslot |
Update the extents for the layer.
This is necessary if features are added/deleted or the layer has been subsetted.
- Parameters
-
force trueto update layer extent even if it's read from xml by default,falseotherwise
Definition at line 801 of file qgsvectorlayer.cpp.
◆ updateFeature()
| bool QgsVectorLayer::updateFeature | ( | QgsFeature & | feature, |
| bool | skipDefaultValues = false |
||
| ) |
Updates an existing feature in the layer, replacing the attributes and geometry for the feature with matching QgsFeature::id() with the attributes and geometry from feature.
Changes are not immediately committed to the layer.
If skipDefaultValue is set to true, default field values will not be updated. This can be used to override default field value expressions.
Returns true if the feature's attribute was successfully changed.
- Note
- Calls to updateFeature() are only valid for layers in which edits have been enabled by a call to startEditing(). Changes made to features using this method are not committed to the underlying data provider until a commitChanges() call is made. Any uncommitted changes can be discarded by calling rollBack().
- Warning
- This method needs to query the underlying data provider to fetch the feature with matching QgsFeature::id() on every call. Depending on the underlying data source this can be slow to execute. Consider using the more efficient changeAttributeValue() or changeGeometry() methods instead.
Definition at line 1037 of file qgsvectorlayer.cpp.
◆ updateFields()
| void QgsVectorLayer::updateFields | ( | ) |
Will regenerate the fields property of this layer by obtaining all fields from the dataProvider, joined fields and virtual fields.
It will also take any changes made to default values into consideration.
- Note
- Unless the fields on the provider have directly been modified, there is no reason to call this method.
Definition at line 3771 of file qgsvectorlayer.cpp.
◆ vectorJoins()
| const QList< QgsVectorLayerJoinInfo > QgsVectorLayer::vectorJoins | ( | ) | const |
Definition at line 3732 of file qgsvectorlayer.cpp.
◆ weakRelations()
| QList< QgsWeakRelation > QgsVectorLayer::weakRelations | ( | ) | const |
Returns the layer's weak relations as specified in the layer's style.
- Returns
- A list of weak relations
- Note
- not available in Python bindings
- Since
- QGIS 3.12
Definition at line 5182 of file qgsvectorlayer.cpp.
◆ wkbType()
|
virtual |
Returns the WKBType or WKBUnknown in case of error.
Implements QgsFeatureSource.
Definition at line 664 of file qgsvectorlayer.cpp.
◆ writeCustomSymbology
|
signal |
Signal emitted whenever the symbology (QML-file) for this layer is being written.
If there is custom style information you want to save to the file, you can connect to this signal and update the element accordingly.
- Parameters
-
element The XML element where you can add additional style information to. doc The XML document that you can use to create new XML nodes. errorMessage Write error messages into this string.
◆ writeSld()
| bool QgsVectorLayer::writeSld | ( | QDomNode & | node, |
| QDomDocument & | doc, | ||
| QString & | errorMessage, | ||
| const QgsStringMap & | props = QgsStringMap() |
||
| ) | const |
Writes the symbology of the layer into the document provided in SLD 1.1 format.
- Parameters
-
node the node that will have the style element added to it. doc the document that will have the QDomNode added. errorMessage reference to string that will be updated with any error messages props a open ended set of properties that can drive/inform the SLD encoding
- Returns
truein case of success
Definition at line 2904 of file qgsvectorlayer.cpp.
◆ writeStyle()
| bool QgsVectorLayer::writeStyle | ( | QDomNode & | node, |
| QDomDocument & | doc, | ||
| QString & | errorMessage, | ||
| const QgsReadWriteContext & | context, | ||
| QgsMapLayer::StyleCategories | categories = QgsMapLayer::AllStyleCategories |
||
| ) | const |
Writes just the style information for the layer into the document.
- Parameters
-
node the node that will have the style element added to it. doc the document that will have the QDomNode added. errorMessage reference to string that will be updated with any error messages context writing context (used for transform from absolute to relative paths) categories the style categories to be written
- Returns
truein case of success.
Definition at line 2797 of file qgsvectorlayer.cpp.
◆ writeSymbology()
| bool QgsVectorLayer::writeSymbology | ( | QDomNode & | node, |
| QDomDocument & | doc, | ||
| QString & | errorMessage, | ||
| const QgsReadWriteContext & | context, | ||
| QgsMapLayer::StyleCategories | categories = QgsMapLayer::AllStyleCategories |
||
| ) | const |
Writes the symbology for the layer into the document provided.
- Parameters
-
node the node that will have the style element added to it. doc the document that will have the QDomNode added. errorMessage reference to string that will be updated with any error messages context writing context (used for transform from absolute to relative paths) categories the style categories to be written
- Returns
truein case of success.
Definition at line 2614 of file qgsvectorlayer.cpp.
◆ writeXml()
|
virtual |
Writes vector layer specific state to project file Dom node.
- Note
- Called by QgsMapLayer::writeXml().
Reimplemented from QgsMapLayer.
Definition at line 1854 of file qgsvectorlayer.cpp.
Friends And Related Function Documentation
◆ QgsVectorLayerEditBuffer
|
friend |
Definition at line 2930 of file qgsvectorlayer.h.
◆ QgsVectorLayerEditPassthrough
|
friend |
Definition at line 2931 of file qgsvectorlayer.h.
◆ QgsVectorLayerFeatureSource
|
friend |
Definition at line 2985 of file qgsvectorlayer.h.
Property Documentation
◆ displayExpression
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
◆ editFormConfig
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
◆ mapTipTemplate
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
◆ opacity
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
◆ readOnly
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
◆ subsetString
|
readwrite |
Definition at line 85 of file qgsvectorlayer.h.
The documentation for this class was generated from the following files:
- /build/qgis-3.16.0+99unstable/src/core/qgsvectorlayer.h
- /build/qgis-3.16.0+99unstable/src/core/qgsvectorlayer.cpp
