Base class for all map layer types. More...

#include <qgsmaplayer.h>

Inheritance diagram for QgsMapLayer:

[legend]

Public Types
enum	LayerType { VectorLayer, RasterLayer, PluginLayer }
	Layers enum defining the types of layers that can be added to a map. More...

Public Slots
Q_DECL_DEPRECATED void	clearCacheImage ()
	Clear cached image. More...

void	emitStyleChanged ()
	Triggers an emission of the styleChanged() signal. More...

virtual void	invalidTransformInput ()
	Event handler for when a coordinate transform fails due to bad vertex error. More...

virtual QString	metadata ()
	Obtain Metadata for this layer. More...

void	setMaximumScale (double theMaxScale)
	Sets the maximum scale denominator at which the layer will be visible. More...

void	setMinimumScale (double theMinScale)
	Sets the minimum scale denominator at which the layer will be visible. More...

void	setScaleBasedVisibility (const bool enabled)
	Sets whether scale based visibility is enabled for the layer. More...

virtual QDateTime	timestamp () const
	Time stamp of data source in the moment when data/metadata were loaded by provider. More...

Q_DECL_DEPRECATED void	toggleScaleBasedVisibility (bool theVisibilityFlag)
	Accessor for the scale based visilibility flag. More...

void	triggerRepaint ()
	Will advice the map canvas (and any other interested party) that this layer requires to be repainted. More...

Signals
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	dataChanged ()
	Data of layer changed. More...

Q_DECL_DEPRECATED void	drawingProgress (int theProgress, int theTotalSteps)

void	layerCrsChanged ()
	Emit a signal that layer's CRS has been reset. More...

Q_DECL_DEPRECATED void	layerNameChanged ()
	Emit a signal that the layer name has been changed. More...

void	legendChanged ()
	Signal emitted when legend of the layer has changed. More...

void	nameChanged ()
	Emitted when the name has been changed. More...

void	recalculateExtents ()
	This is used to send a request that any mapcanvas using this layer update its extents. More...

void	rendererChanged ()
	Signal emitted when renderer is changed. More...

void	repaintRequested ()
	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	screenUpdateRequested ()

void	statusChanged (const QString &theStatus)
	Emit a signal with status (e.g. More...

void	styleChanged ()
	Signal emitted whenever a change affects the layer's style. More...

Public Member Functions
	QgsMapLayer (QgsMapLayer::LayerType type=VectorLayer, const QString &lyrname=QString::null, const QString &source=QString::null)
	Constructor. More...

virtual	~QgsMapLayer ()
	Destructor. More...

QString	abstract () const
	Get the abstract of the layer used by QGIS Server in GetCapabilities request. More...

QString	attribution () const
	Get the attribution of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers. More...

QString	attributionUrl () const
	Get the attribution URL of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers. More...

QPainter::CompositionMode	blendMode () const
	Returns the current blending mode for a layer. More...

Q_DECL_DEPRECATED QImage *	cacheImage ()

virtual QgsMapLayerRenderer *	createMapRenderer (QgsRenderContext &rendererContext)
	Return new instance of QgsMapLayerRenderer that will be used for rendering of given context. More...

const QgsCoordinateReferenceSystem &	crs () const
	Returns layer's spatial reference system. More...

QVariant	customProperty (const QString &value, const QVariant &defaultValue=QVariant()) const
	Read a custom property from layer. More...

QString	dataUrl () const
	Get the DataUrl of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer. More...

QString	dataUrlFormat () const
	Get the DataUrl format of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer. More...

virtual bool	draw (QgsRenderContext &rendererContext)
	This is the method that does the actual work of drawing the layer onto a paint device. More...

virtual void	drawLabels (QgsRenderContext &rendererContext)
	Draw labels. More...

virtual QgsError	error () const
	Get current status error. More...

virtual void	exportNamedStyle (QDomDocument &doc, QString &errorMsg)
	Export the properties of this layer as named style in a QDomDocument. More...

virtual void	exportSldStyle (QDomDocument &doc, QString &errorMsg)
	Export the properties of this layer as SLD style in a QDomDocument. More...

virtual QgsRectangle	extent ()
	Return the extent of the layer. More...

bool	hasScaleBasedVisibility () const
	Returns whether scale based visibility is enabled for the layer. More...

QString	id () const
	Get this layer's unique ID, this ID is used to access this layer from map layer registry. More...

virtual bool	importNamedStyle (QDomDocument &doc, QString &errorMsg)
	Import the properties of this layer from a QDomDocument. More...

virtual bool	isEditable () const
	True if the layer can be edited. More...

bool	isInScaleRange (double scale) const
	Tests whether the layer should be visible at the specified scale. More...

virtual bool	isSpatial () const
	Returns true if the layer is considered a spatial layer, ie it has some form of geometry associated with it. More...

bool	isValid ()
	Return the status of the layer. More...

QString	keywordList () const
	Get the keyword list of the layer used by QGIS Server in GetCapabilities request. More...

virtual Q_DECL_DEPRECATED QString	lastError ()

virtual Q_DECL_DEPRECATED QString	lastErrorTitle ()

QgsMapLayerLegend *	legend () const
	Can be null. More...

QString	legendUrl () const

QString	legendUrlFormat () const

virtual QString	loadDefaultStyle (bool &theResultFlag)
	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 &theResultFlag)
	Retrieve a named 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 bool	loadNamedStyleFromDb (const QString &db, const QString &theURI, QString &qml)

virtual QString	loadSldStyle (const QString &theURI, bool &theResultFlag)

double	maximumScale () const
	Returns the maximum scale denominator at which the layer is visible. More...

QString	metadataUrl () const
	Get the metadata URL of the layer used by QGIS Server in GetCapabilities request MetadataUrl is a a link to the detailed, standardized metadata about the data. More...

QString	metadataUrlFormat () const
	Get the metadata format of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates how the metadata is structured. More...

QString	metadataUrlType () const
	Get the metadata type of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates the standard to which the metadata complies. More...

double	minimumScale () const
	Returns the minimum scale denominator at which the layer is visible. More...

QString	name () const
	Get the display name of the layer. More...

virtual Q_DECL_DEPRECATED void	onCacheImageDelete ()

QString	originalName () const
	Get the original name of the 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, const QString &relativeBasePath=QString())
	Sets state from Dom document. More...

bool	readOnly () const
	Returns if this layer is read only. More...

virtual bool	readSld (const QDomNode &node, QString &errorMessage)

virtual bool	readStyle (const QDomNode &node, QString &errorMessage)
	Read the style for the current layer from the Dom node supplied. More...

virtual bool	readSymbology (const QDomNode &node, QString &errorMessage)=0
	Read the symbology for the current layer from the Dom node supplied. More...

virtual void	reload ()
	Synchronises with changes in the datasource. More...

void	removeCustomProperty (const QString &key)
	Remove a custom property from layer. More...

virtual QString	saveDefaultStyle (bool &theResultFlag)
	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...

virtual QString	saveNamedStyle (const QString &theURI, bool &theResultFlag)
	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 &theURI, bool &theResultFlag)

void	setAbstract (const QString &abstract)
	Set the abstract of the layer used by QGIS Server in GetCapabilities request. More...

void	setAttribution (const QString &attrib)
	Set the attribution of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers. More...

void	setAttributionUrl (const QString &attribUrl)
	Set the attribution URL of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers. More...

void	setBlendMode (QPainter::CompositionMode blendMode)
	Set the blending mode used for rendering a layer. More...

Q_DECL_DEPRECATED void	setCacheImage (QImage *)

void	setCrs (const QgsCoordinateReferenceSystem &srs, bool emitSignal=true)
	Sets layer's spatial reference system. More...

void	setCustomProperty (const QString &key, const QVariant &value)
	Set a custom property for layer. More...

void	setDataUrl (const QString &dataUrl)
	Set the DataUrl of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer. More...

void	setDataUrlFormat (const QString &dataUrlFormat)
	Set the DataUrl format of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer. More...

void	setKeywordList (const QString &keywords)
	Set the keyword list of the layer used by QGIS Server in GetCapabilities request. More...

Q_DECL_DEPRECATED void	setLayerName (const QString &name)
	Set the display name of the layer. More...

virtual void	setLayerOrder (const QStringList &layers)
	Reorders the previously selected sublayers of this layer from bottom to top (Useful for providers that manage their own layers, such as WMS) More...

void	setLegend (QgsMapLayerLegend *legend)
	Assign a legend controller to the map layer. More...

void	setLegendUrl (const QString &legendUrl)

void	setLegendUrlFormat (const QString &legendUrlFormat)

void	setMetadataUrl (const QString &metaUrl)
	Set the metadata URL of the layer used by QGIS Server in GetCapabilities request MetadataUrl is a a link to the detailed, standardized metadata about the data. More...

void	setMetadataUrlFormat (const QString &metaUrlFormat)
	Set the metadata format of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates how the metadata is structured. 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	setShortName (const QString &shortName)
	Set the short name of the layer used by QGIS Server to identify the layer. More...

virtual void	setSubLayerVisibility (const QString &name, bool vis)
	Set the visibility of the given sublayer name. More...

void	setTitle (const QString &title)
	Set the title of the layer used by QGIS Server in GetCapabilities request. More...

QString	shortName () const
	Get 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
	Get access to the layer's style manager. More...

virtual QString	styleURI ()
	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 (Useful for providers that manage their own layers, such as WMS) More...

QString	title () const
	Get the title of the layer used by QGIS Server in GetCapabilities request. More...

QgsMapLayer::LayerType	type () const
	Get the type of the layer. More...

QUndoStack *	undoStack ()
	Return pointer to layer's undo stack. More...

QUndoStack *	undoStackStyles ()
	Return pointer to layer's style undo stack. More...

bool	writeLayerXML (QDomElement &layerElement, QDomDocument &document, const QString &relativeBasePath=QString())
	Stores state in Dom node. More...

virtual bool	writeStyle (QDomNode &node, QDomDocument &doc, QString &errorMessage) const
	Write just the style information for the layer into the document. More...

virtual bool	writeSymbology (QDomNode &node, QDomDocument &doc, QString &errorMessage) const =0
	Write the symbology for the layer into the docment provided. More...

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

virtual	~QObject ()

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Static Public Member Functions
static QDomDocument	asLayerDefinition (const QList< QgsMapLayer *> &layers, const QString &relativeBasePath=QString())
	Returns the given layer as a layer definition document Layer definitions store the data source as well as styling and custom properties. More...

static QString	capitaliseLayerName (const QString &name)
	A convenience function to (un)capitalise the layer name. More...

static QList< QgsMapLayer * >	fromLayerDefinition (QDomDocument &document, bool addToRegistry=false, bool addToLegend=false, const QString &relativeBasePath=QString())
	Creates a new layer from a layer defininition document. More...

static QList< QgsMapLayer * >	fromLayerDefinitionFile (const QString &qlrfile)

Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Protected Member Functions
void	appendError (const QgsErrorMessage &theMessage)
	Add error message. More...

void	readCustomProperties (const QDomNode &layerNode, const QString &keyStartsWith="")
	Read custom properties from project file. More...

void	readStyleManager (const QDomNode &layerNode)
	Read style manager's configuration (if any). More...

virtual bool	readXml (const QDomNode &layer_node)
	Called by readLayerXML(), used by children to read state specific to them from project files. More...

void	setError (const QgsError &theError)
	Set error message. More...

virtual void	setExtent (const QgsRectangle &rect)
	Set the extent. More...

void	setValid (bool valid)
	Set whether layer is valid or not - should be used in constructor. 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). More...

virtual bool	writeXml (QDomNode &layer_node, QDomDocument &document)
	Called by writeLayerXML(), used by children to write state specific to them to project files. More...

Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Protected Attributes
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

QgsError	mError
	Error. More...

QgsRectangle	mExtent
	Extent of the layer. More...

QString	mKeywordList

QString	mLayerName
	Name of the layer - used for display. More...

QString	mLayerOrigName
	Original name of the layer. More...

QString	mLegendUrl
	WMS legend. More...

QString	mLegendUrlFormat

QString	mMetadataUrl
	MetadataUrl of the layer. More...

QString	mMetadataUrlFormat

QString	mMetadataUrlType

QString	mShortName

QString	mTitle

bool	mValid
	Indicates if the layer is valid and can be drawn. More...

Properties
QString	name
	Read property of QString layerName. More...

Properties inherited from QObject
	objectName

Additional Inherited Members
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Detailed Description

Base class for all map layer types.

This is the base class for all map layer types (vector, raster).

Definition at line 49 of file qgsmaplayer.h.

Member Enumeration Documentation

◆ LayerType

enum QgsMapLayer::LayerType

Layers enum defining the types of layers that can be added to a map.

Enumerator
VectorLayer
RasterLayer
PluginLayer

Definition at line 57 of file qgsmaplayer.h.

Constructor & Destructor Documentation

◆ QgsMapLayer()

QgsMapLayer::QgsMapLayer	(	QgsMapLayer::LayerType	type = `VectorLayer`,
		const QString &	lyrname = `QString::null`,
		const QString &	source = `QString::null`
	)

Constructor.

Parameters

type	Type of layer as defined in QgsMapLayer::LayerType enum
lyrname	Display Name of the layer
source	datasource of layer

Definition at line 54 of file qgsmaplayer.cpp.

◆ ~QgsMapLayer()

QgsMapLayer::~QgsMapLayer ( )

virtual

Destructor.

Definition at line 93 of file qgsmaplayer.cpp.

Member Function Documentation

◆ abstract()

QString QgsMapLayer::abstract ( ) const

inline

Get the abstract of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer abstract

Definition at line 137 of file qgsmaplayer.h.

◆ appendError()

void QgsMapLayer::appendError ( const QgsErrorMessage & theMessage )

inlineprotected

Add error message.

Definition at line 760 of file qgsmaplayer.h.

◆ asLayerDefinition()

QDomDocument QgsMapLayer::asLayerDefinition	(	const QList< QgsMapLayer *> &	layers,
		const QString &	relativeBasePath = `QString()`
	)

static

Returns the given layer as a layer definition document Layer definitions store the data source as well as styling and custom properties.

Layer definitions can be used to load a layer and styling all from a single file.

Definition at line 804 of file qgsmaplayer.cpp.

◆ attribution()

QString QgsMapLayer::attribution ( ) const

inline

Get the attribution of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers.

Returns: the layer attribution

Definition at line 188 of file qgsmaplayer.h.

◆ attributionUrl()

QString QgsMapLayer::attributionUrl ( ) const

inline

Get the attribution URL of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers.

Returns: the layer attribution URL

Definition at line 200 of file qgsmaplayer.h.

◆ blendMode()

QPainter::CompositionMode QgsMapLayer::blendMode ( ) const

Returns the current blending mode for a layer.

Read blend mode for layer.

Definition at line 161 of file qgsmaplayer.cpp.

◆ blendModeChanged

void QgsMapLayer::blendModeChanged ( QPainter::CompositionMode blendMode )

signal

Signal emitted when the blend mode is changed, through QgsMapLayer::setBlendMode()

◆ cacheImage()

Q_DECL_DEPRECATED QImage* QgsMapLayer::cacheImage ( )

inline

Deprecated:: since 2.4 - returns nullptr

Definition at line 535 of file qgsmaplayer.h.

◆ capitaliseLayerName()

QString QgsMapLayer::capitaliseLayerName ( const QString & name )

static

A convenience function to (un)capitalise the layer name.

Definition at line 1034 of file qgsmaplayer.cpp.

◆ clearCacheImage

void QgsMapLayer::clearCacheImage ( )

slot

Clear cached image.

Deprecated:: in 2.4 - use triggerRepaint() - caches automatically listen to repaintRequested() signal to invalidate the cached image

Definition at line 1710 of file qgsmaplayer.cpp.

◆ configChanged

void QgsMapLayer::configChanged ( )

signal

Emitted whenever the configuration is changed.

The project listens to this signal to be marked as dirty.

◆ createMapRenderer()

virtual QgsMapLayerRenderer* QgsMapLayer::createMapRenderer ( QgsRenderContext & rendererContext )

inlinevirtual

Return new instance of QgsMapLayerRenderer that will be used for rendering of given context.

Note: added in 2.4

Reimplemented in QgsVectorLayer, QgsRasterLayer, and QgsPluginLayer.

Definition at line 255 of file qgsmaplayer.h.

◆ crs()

const QgsCoordinateReferenceSystem & QgsMapLayer::crs ( ) const

Returns layer's spatial reference system.

Note: This was introduced in QGIS 1.4

Definition at line 1015 of file qgsmaplayer.cpp.

◆ customProperty()

QVariant QgsMapLayer::customProperty	(	const QString &	value,
		const QVariant &	defaultValue = `QVariant()`
	)		const

Read a custom property from layer.

Properties are stored in a map and saved in project file.

Definition at line 1659 of file qgsmaplayer.cpp.

◆ dataChanged

void QgsMapLayer::dataChanged ( )

signal

Data of layer changed.

◆ dataUrl()

QString QgsMapLayer::dataUrl ( ) const

inline

Get the DataUrl of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer.

Returns: the layer DataUrl

Definition at line 162 of file qgsmaplayer.h.

◆ dataUrlFormat()

QString QgsMapLayer::dataUrlFormat ( ) const

inline

Get the DataUrl format of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer.

Returns: the layer DataUrl format

Definition at line 174 of file qgsmaplayer.h.

◆ draw()

bool QgsMapLayer::draw ( QgsRenderContext & rendererContext )

virtual

This is the method that does the actual work of drawing the layer onto a paint device.

Parameters

rendererContext describes the extents, resolumon etc. that should be used when rendering the layer.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 166 of file qgsmaplayer.cpp.

◆ drawingProgress

Q_DECL_DEPRECATED void QgsMapLayer::drawingProgress	(	int	theProgress,
		int	theTotalSteps
	)

signal

Deprecated:: in 2.4 - not emitted anymore

◆ drawLabels()

void QgsMapLayer::drawLabels ( QgsRenderContext & rendererContext )

virtual

Draw labels.

Todo:: to be removed: used only in vector layers

Reimplemented in QgsVectorLayer.

Definition at line 172 of file qgsmaplayer.cpp.

◆ emitStyleChanged

void QgsMapLayer::emitStyleChanged ( )

slot

Triggers an emission of the styleChanged() signal.

Note: added in QGIS 2.16

Definition at line 1725 of file qgsmaplayer.cpp.

◆ error()

virtual QgsError QgsMapLayer::error ( ) const

inlinevirtual

Get current status error.

This error describes some principal problem for which layer cannot work and thus is not valid. It is not last error after accessing data by draw() etc.

Definition at line 377 of file qgsmaplayer.h.

◆ exportNamedStyle()

void QgsMapLayer::exportNamedStyle	(	QDomDocument &	doc,
		QString &	errorMsg
	)

virtual

Export the properties of this layer as named style in a QDomDocument.

Parameters

doc	the target QDomDocument
errorMsg	this QString will be initialized on error during the execution of writeSymbology

Definition at line 1258 of file qgsmaplayer.cpp.

◆ exportSldStyle()

void QgsMapLayer::exportSldStyle	(	QDomDocument &	doc,
		QString &	errorMsg
	)

virtual

Export the properties of this layer as SLD style in a QDomDocument.

Parameters

doc	the target QDomDocument
errorMsg	this QString will be initialized on error during the execution of writeSymbology

Definition at line 1457 of file qgsmaplayer.cpp.

◆ extent()

QgsRectangle QgsMapLayer::extent ( )

virtual

Return the extent of the layer.

Reimplemented in QgsVectorLayer.

Definition at line 147 of file qgsmaplayer.cpp.

◆ fromLayerDefinition()

QList< QgsMapLayer * > QgsMapLayer::fromLayerDefinition	(	QDomDocument &	document,
		bool	addToRegistry = `false`,
		bool	addToLegend = `false`,
		const QString &	relativeBasePath = `QString()`
	)

static

Creates a new layer from a layer defininition document.

Definition at line 820 of file qgsmaplayer.cpp.

◆ fromLayerDefinitionFile()

QList< QgsMapLayer * > QgsMapLayer::fromLayerDefinitionFile ( const QString & qlrfile )

static

Definition at line 861 of file qgsmaplayer.cpp.

◆ hasScaleBasedVisibility()

bool QgsMapLayer::hasScaleBasedVisibility ( ) const

Returns whether scale based visibility is enabled for the layer.

Returns: true if scale based visibility is enabled

See also: minimumScale(); maximumScale(); setScaleBasedVisibility(); isInScaleRange()

Definition at line 966 of file qgsmaplayer.cpp.

◆ id()

QString QgsMapLayer::id ( ) const

Get this layer's unique ID, this ID is used to access this layer from map layer registry.

Get this layer's unique ID.

Definition at line 105 of file qgsmaplayer.cpp.

◆ importNamedStyle()

bool QgsMapLayer::importNamedStyle	(	QDomDocument &	doc,
		QString &	errorMsg
	)

virtual

Import the properties of this layer from a QDomDocument.

Parameters

doc	source QDomDocument
errorMsg	this QString will be initialized on error during the execution of readSymbology

Returns: true on success

Note: added in 2.8

Definition at line 1207 of file qgsmaplayer.cpp.

◆ invalidTransformInput

void QgsMapLayer::invalidTransformInput ( )

virtualslot

Event handler for when a coordinate transform fails due to bad vertex error.

Definition at line 931 of file qgsmaplayer.cpp.

◆ isEditable()

bool QgsMapLayer::isEditable ( ) const

virtual

True if the layer can be edited.

Reimplemented in QgsVectorLayer.

Definition at line 1671 of file qgsmaplayer.cpp.

◆ isInScaleRange()

bool QgsMapLayer::isInScaleRange ( double scale ) const

Tests whether the layer should be visible at the specified scale.

Parameters

scale scale denominator to test

Returns: true if the layer is visible at the given scale.

Note: added in QGIS 2.16

See also: minimumScale(); maximumScale(); hasScaleBasedVisibility()

Definition at line 956 of file qgsmaplayer.cpp.

◆ isSpatial()

virtual bool QgsMapLayer::isSpatial ( ) const

inlinevirtual

Returns true if the layer is considered a spatial layer, ie it has some form of geometry associated with it.

Note: added in QGIS 2.16

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 309 of file qgsmaplayer.h.

◆ isValid()

bool QgsMapLayer::isValid ( )

Return the status of the layer.

An invalid layer is one which has a bad datasource or other problem. Child classes set this flag when intialized

Returns: True if the layer is valid and can be accessed

Definition at line 925 of file qgsmaplayer.cpp.

◆ keywordList()

QString QgsMapLayer::keywordList ( ) const

inline

Get the keyword list of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer keyword list

Definition at line 148 of file qgsmaplayer.h.

◆ lastError()

QString QgsMapLayer::lastError ( )

virtual

Deprecated:: since 2.4 - returns empty string

Definition at line 943 of file qgsmaplayer.cpp.

◆ lastErrorTitle()

QString QgsMapLayer::lastErrorTitle ( )

virtual

Deprecated:: since 2.4 - returns empty string

Definition at line 938 of file qgsmaplayer.cpp.

◆ layerCrsChanged

void QgsMapLayer::layerCrsChanged ( )

signal

Emit a signal that layer's CRS has been reset.

◆ layerNameChanged

Q_DECL_DEPRECATED void QgsMapLayer::layerNameChanged ( )

signal

Emit a signal that the layer name has been changed.

Deprecated:: since 2.16 use nameChanged() instead

◆ legend()

QgsMapLayerLegend * QgsMapLayer::legend ( ) const

Can be null.

Note: added in 2.6

Definition at line 1700 of file qgsmaplayer.cpp.

◆ legendChanged

void QgsMapLayer::legendChanged ( )

signal

Signal emitted when legend of the layer has changed.

Note: added in 2.6

◆ legendUrl()

QString QgsMapLayer::legendUrl ( ) const

inline

Definition at line 530 of file qgsmaplayer.h.

◆ legendUrlFormat()

QString QgsMapLayer::legendUrlFormat ( ) const

inline

Definition at line 532 of file qgsmaplayer.h.

◆ loadDefaultStyle()

QString QgsMapLayer::loadDefaultStyle ( bool & theResultFlag )

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

theResultFlag a reference to a flag that will be set to false if we did not manage to load the default style.

Returns: a QString with any status messages

See also: also loadNamedStyle ();

Definition at line 1101 of file qgsmaplayer.cpp.

◆ loadNamedStyle()

QString QgsMapLayer::loadNamedStyle	(	const QString &	theURI,
		bool &	theResultFlag
	)

virtual

Retrieve a named 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

theURI	- the file name or other URI for the style file. First an attempt will be made to see if this is a file and load that, if that fails the qgis.db styles table will be consulted to see if there is a style who's key matches the URI.
theResultFlag	a reference to a flag that will be set to false if we did not manage to load the default style.

Returns: a QString with any status messages

See also: also loadDefaultStyle ();

Reimplemented in QgsVectorLayer.

Definition at line 1151 of file qgsmaplayer.cpp.

◆ loadNamedStyleFromDb()

bool QgsMapLayer::loadNamedStyleFromDb	(	const QString &	db,
		const QString &	theURI,
		QString &	qml
	)

virtual

Definition at line 1106 of file qgsmaplayer.cpp.

◆ loadSldStyle()

QString QgsMapLayer::loadSldStyle	(	const QString &	theURI,
		bool &	theResultFlag
	)

virtual

Definition at line 1566 of file qgsmaplayer.cpp.

◆ maximumScale()

double QgsMapLayer::maximumScale ( ) const

Returns the maximum scale denominator at which the layer is visible.

Scale based visibility is only used if hasScaleBasedVisibility is true.

Returns: minimum scale denominator at which the layer will render

See also: setMaximumScale(); minimumScale(); hasScaleBasedVisibility(); isInScaleRange()

Definition at line 992 of file qgsmaplayer.cpp.

◆ metadata

QString QgsMapLayer::metadata ( )

virtualslot

Obtain Metadata for this layer.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 1720 of file qgsmaplayer.cpp.

◆ metadataUrl()

QString QgsMapLayer::metadataUrl ( ) const

inline

Get the metadata URL of the layer used by QGIS Server in GetCapabilities request MetadataUrl is a a link to the detailed, standardized metadata about the data.

Returns: the layer metadata URL

Definition at line 214 of file qgsmaplayer.h.

◆ metadataUrlFormat()

QString QgsMapLayer::metadataUrlFormat ( ) const

inline

Get the metadata format of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates how the metadata is structured.

Returns: the layer metadata format

Definition at line 238 of file qgsmaplayer.h.

◆ metadataUrlType()

QString QgsMapLayer::metadataUrlType ( ) const

inline

Get the metadata type of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates the standard to which the metadata complies.

Returns: the layer metadata type

Definition at line 226 of file qgsmaplayer.h.

◆ minimumScale()

double QgsMapLayer::minimumScale ( ) const

Returns the minimum scale denominator at which the layer is visible.

Scale based visibility is only used if hasScaleBasedVisibility is true.

Returns: minimum scale denominator at which the layer will render

See also: setMinimumScale(); maximumScale(); hasScaleBasedVisibility(); isInScaleRange()

Definition at line 976 of file qgsmaplayer.cpp.

◆ name()

QString QgsMapLayer::name ( ) const

Get the display name of the layer.

Returns: the layer name

◆ nameChanged

void QgsMapLayer::nameChanged ( )

signal

Emitted when the name has been changed.

Note: added in 2.16

◆ onCacheImageDelete()

virtual Q_DECL_DEPRECATED void QgsMapLayer::onCacheImageDelete ( )

inlinevirtual

Deprecated:: since 2.4 - does nothing

Definition at line 539 of file qgsmaplayer.h.

◆ originalName()

QString QgsMapLayer::originalName ( ) const

inline

Get the original name of the layer.

Returns: the original layer name

Definition at line 104 of file qgsmaplayer.h.

◆ publicSource()

QString QgsMapLayer::publicSource ( ) const

Gets a version of the internal layer definition that has sensitive bits removed (for example, the password).

This function should be used when displaying the source name for general viewing.

Definition at line 134 of file qgsmaplayer.cpp.

◆ readCustomProperties()

void QgsMapLayer::readCustomProperties	(	const QDomNode &	layerNode,
		const QString &	keyStartsWith = `""`
	)

protected

Read custom properties from project file.

Parameters

layerNode	note to read from
keyStartsWith	reads only properties starting with the specified string (or all if the string is empty)

Definition at line 893 of file qgsmaplayer.cpp.

◆ readLayerXML()

bool QgsMapLayer::readLayerXML	(	const QDomElement &	layerElement,
		const QString &	relativeBasePath = `QString()`
	)

Sets state from Dom document.

Parameters

layerElement	The Dom element corresponding to ``maplayer'' tag
relativeBasePath	base path for relative paths

Note

The Dom node corresponds to a Dom document project file XML element read by QgsProject.

This, in turn, calls readXml(), which is over-rideable by sub-classes so that they can read their own specific state from the given Dom node.

Invoked by QgsProject::read().

Returns: true if successful

Definition at line 177 of file qgsmaplayer.cpp.

◆ readOnly()

bool QgsMapLayer::readOnly ( ) const

inline

Returns if this layer is read only.

Definition at line 246 of file qgsmaplayer.h.

◆ readSld()

virtual bool QgsMapLayer::readSld	(	const QDomNode &	node,
		QString &	errorMessage
	)

inlinevirtual

Reimplemented in QgsVectorLayer.

Definition at line 481 of file qgsmaplayer.h.

◆ readStyle()

bool QgsMapLayer::readStyle	(	const QDomNode &	node,
		QString &	errorMessage
	)

virtual

Read 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

Returns: true in case of success.

Note: added in 2.16; To be implemented in subclasses. Default implementation does nothing and returns false.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 1627 of file qgsmaplayer.cpp.

◆ readStyleManager()

void QgsMapLayer::readStyleManager ( const QDomNode & layerNode )

protected

Read style manager's configuration (if any).

To be called by subclasses.

Definition at line 903 of file qgsmaplayer.cpp.

◆ readSymbology()

virtual bool QgsMapLayer::readSymbology	(	const QDomNode &	node,
		QString &	errorMessage
	)

pure virtual

Read the symbology for the current layer from the Dom node supplied.

Parameters

node	node that will contain the symbology definition for this layer.
errorMessage	reference to string that will be updated with any error messages

Returns: true in case of success.

Implemented in QgsVectorLayer, and QgsRasterLayer.

◆ readXml()

bool QgsMapLayer::readXml ( const QDomNode & layer_node )

protectedvirtual

Called by readLayerXML(), used by children to read state specific to them from project files.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 532 of file qgsmaplayer.cpp.

◆ recalculateExtents

void QgsMapLayer::recalculateExtents ( )

signal

This is used to send a request that any mapcanvas using this layer update its extents.

◆ reload()

virtual void QgsMapLayer::reload ( )

inlinevirtual

Synchronises with changes in the datasource.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 250 of file qgsmaplayer.h.

◆ removeCustomProperty()

void QgsMapLayer::removeCustomProperty ( const QString & key )

Remove a custom property from layer.

Properties are stored in a map and saved in project file.

Definition at line 1664 of file qgsmaplayer.cpp.

◆ rendererChanged

void QgsMapLayer::rendererChanged ( )

signal

Signal emitted when renderer is changed.

See also: styleChanged()

◆ repaintRequested

void QgsMapLayer::repaintRequested ( )

signal

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.

◆ saveDefaultStyle()

QString QgsMapLayer::saveDefaultStyle ( bool & theResultFlag )

virtual

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)

Parameters

theResultFlag a reference to a flag that will be set to false if we did not manage to save the default style.

Returns: a QString with any status messages

See also: loadNamedStyle() and; saveNamedStyle()

Definition at line 1307 of file qgsmaplayer.cpp.

◆ saveNamedStyle()

QString QgsMapLayer::saveNamedStyle	(	const QString &	theURI,
		bool &	theResultFlag
	)

virtual

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)

Parameters

theURI	the file name or other URI for the style file. First an attempt will be made to see if this is a file and save to that, if that fails the qgis.db styles table will be used to create a style entry who's key matches the URI.
theResultFlag	a reference to a flag that will be set to false if we did not manage to save the default style.

Returns: a QString with any status messages

See also: saveDefaultStyle()

Definition at line 1312 of file qgsmaplayer.cpp.

◆ saveSldStyle()

QString QgsMapLayer::saveSldStyle	(	const QString &	theURI,
		bool &	theResultFlag
	)

virtual

Definition at line 1501 of file qgsmaplayer.cpp.

◆ screenUpdateRequested

void QgsMapLayer::screenUpdateRequested ( )

signal

Note: Deprecated in 2.4 and not emitted anymore

◆ setAbstract()

void QgsMapLayer::setAbstract ( const QString & abstract )

inline

Set the abstract of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer abstract

Definition at line 132 of file qgsmaplayer.h.

◆ setAttribution()

void QgsMapLayer::setAttribution ( const QString & attrib )

inline

Set the attribution of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers.

Returns: the layer attribution

Definition at line 182 of file qgsmaplayer.h.

◆ setAttributionUrl()

void QgsMapLayer::setAttributionUrl ( const QString & attribUrl )

inline

Set the attribution URL of the layer used by QGIS Server in GetCapabilities request Attribution indicates the provider of a Layer or collection of Layers.

Returns: the layer attribution URL

Definition at line 194 of file qgsmaplayer.h.

◆ setBlendMode()

void QgsMapLayer::setBlendMode ( QPainter::CompositionMode blendMode )

Set the blending mode used for rendering a layer.

Write blend mode for layer.

Definition at line 153 of file qgsmaplayer.cpp.

◆ setCacheImage()

void QgsMapLayer::setCacheImage ( QImage * )

Deprecated:: since 2.4 - caches listen to repaintRequested() signal to invalidate the cached image

Definition at line 1681 of file qgsmaplayer.cpp.

◆ setCrs()

void QgsMapLayer::setCrs	(	const QgsCoordinateReferenceSystem &	srs,
		bool	emitSignal = `true`
	)

Sets layer's spatial reference system.

Definition at line 1020 of file qgsmaplayer.cpp.

◆ setCustomProperty()

void QgsMapLayer::setCustomProperty	(	const QString &	key,
		const QVariant &	value
	)

Set a custom property for layer.

Properties are stored in a map and saved in project file.

Definition at line 1654 of file qgsmaplayer.cpp.

◆ setDataUrl()

void QgsMapLayer::setDataUrl ( const QString & dataUrl )

inline

Set the DataUrl of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer.

Returns: the layer DataUrl

Definition at line 156 of file qgsmaplayer.h.

◆ setDataUrlFormat()

void QgsMapLayer::setDataUrlFormat ( const QString & dataUrlFormat )

inline

Set the DataUrl format of the layer used by QGIS Server in GetCapabilities request DataUrl is a a link to the underlying data represented by a particular layer.

Returns: the layer DataUrl format

Definition at line 168 of file qgsmaplayer.h.

◆ setError()

void QgsMapLayer::setError ( const QgsError & theError )

inlineprotected

Set error message.

Definition at line 762 of file qgsmaplayer.h.

◆ setExtent()

void QgsMapLayer::setExtent ( const QgsRectangle & rect )

protectedvirtual

Set the extent.

Reimplemented in QgsVectorLayer, and QgsPluginLayer.

Definition at line 1730 of file qgsmaplayer.cpp.

◆ setKeywordList()

void QgsMapLayer::setKeywordList ( const QString & keywords )

inline

Set the keyword list of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer keyword list

Definition at line 143 of file qgsmaplayer.h.

◆ setLayerName()

void QgsMapLayer::setLayerName ( const QString & name )

Set the display name of the layer.

Parameters

name	New name for the layer

Deprecated:: Since 2.16, use setName instead

Definition at line 110 of file qgsmaplayer.cpp.

◆ setLayerOrder()

void QgsMapLayer::setLayerOrder ( const QStringList & layers )

virtual

Reorders the previously selected sublayers of this layer from bottom to top (Useful for providers that manage their own layers, such as WMS)

Reimplemented in QgsRasterLayer.

Definition at line 1002 of file qgsmaplayer.cpp.

◆ setLegend()

void QgsMapLayer::setLegend ( QgsMapLayerLegend * legend )

Assign a legend controller to the map layer.

The object will be responsible for providing legend items.

Parameters

legend Takes ownership of the object. Can be null pointer

Note: added in 2.6

Definition at line 1686 of file qgsmaplayer.cpp.

◆ setLegendUrl()

void QgsMapLayer::setLegendUrl ( const QString & legendUrl )

inline

Definition at line 529 of file qgsmaplayer.h.

◆ setLegendUrlFormat()

void QgsMapLayer::setLegendUrlFormat ( const QString & legendUrlFormat )

inline

Definition at line 531 of file qgsmaplayer.h.

◆ setMaximumScale

void QgsMapLayer::setMaximumScale ( double theMaxScale )

slot

Sets the maximum scale denominator at which the layer will be visible.

Scale based visibility is only used if setScaleBasedVisibility is set to true.

Parameters

theMaxScale maximum scale denominator at which the layer should render

See also: maximumScale; setMinimumScale; setScaleBasedVisibility

Definition at line 982 of file qgsmaplayer.cpp.

◆ setMetadataUrl()

void QgsMapLayer::setMetadataUrl ( const QString & metaUrl )

inline

Set the metadata URL of the layer used by QGIS Server in GetCapabilities request MetadataUrl is a a link to the detailed, standardized metadata about the data.

Returns: the layer metadata URL

Definition at line 208 of file qgsmaplayer.h.

◆ setMetadataUrlFormat()

void QgsMapLayer::setMetadataUrlFormat ( const QString & metaUrlFormat )

inline

Set the metadata format of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates how the metadata is structured.

Returns: the layer metadata format

Definition at line 232 of file qgsmaplayer.h.

◆ setMetadataUrlType()

void QgsMapLayer::setMetadataUrlType ( const QString & metaUrlType )

inline

Set the metadata type of the layer used by QGIS Server in GetCapabilities request MetadataUrlType indicates the standard to which the metadata complies.

Returns: the layer metadata type

Definition at line 220 of file qgsmaplayer.h.

◆ setMinimumScale

void QgsMapLayer::setMinimumScale ( double theMinScale )

slot

Sets the minimum scale denominator at which the layer will be visible.

Scale based visibility is only used if setScaleBasedVisibility is set to true.

Parameters

theMinScale minimum scale denominator at which the layer should render

See also: minimumScale; setMaximumScale; setScaleBasedVisibility

Definition at line 971 of file qgsmaplayer.cpp.

◆ setName()

void QgsMapLayer::setName ( const QString & name )

Set the display name of the layer.

Parameters

name	New name for the layer

Note: added in 2.16

Definition at line 115 of file qgsmaplayer.cpp.

◆ setScaleBasedVisibility

void QgsMapLayer::setScaleBasedVisibility ( const bool enabled )

slot

Sets whether scale based visibility is enabled for the layer.

Parameters

enabled set to true to enable scale based visibility

See also: setMinimumScale; setMaximumScale; scaleBasedVisibility

Definition at line 987 of file qgsmaplayer.cpp.

◆ setShortName()

void QgsMapLayer::setShortName ( const QString & shortName )

inline

Set the short name of the layer used by QGIS Server to identify the layer.

Returns: the layer short name

Definition at line 110 of file qgsmaplayer.h.

◆ setSubLayerVisibility()

void QgsMapLayer::setSubLayerVisibility	(	const QString &	name,
		bool	vis
	)

virtual

Set the visibility of the given sublayer name.

Reimplemented in QgsRasterLayer.

Definition at line 1008 of file qgsmaplayer.cpp.

◆ setTitle()

void QgsMapLayer::setTitle ( const QString & title )

inline

Set the title of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer title

Definition at line 121 of file qgsmaplayer.h.

◆ setValid()

void QgsMapLayer::setValid ( bool valid )

protected

Set whether layer is valid or not - should be used in constructor.

Definition at line 1676 of file qgsmaplayer.cpp.

◆ shortName()

QString QgsMapLayer::shortName ( ) const

inline

Get the short name of the layer used by QGIS Server to identify the layer.

Returns: the layer short name

Definition at line 115 of file qgsmaplayer.h.

◆ source()

QString QgsMapLayer::source ( ) const

Returns the source for the layer.

Definition at line 142 of file qgsmaplayer.cpp.

◆ statusChanged

void QgsMapLayer::statusChanged ( const QString & theStatus )

signal

Emit a signal with status (e.g.

to be caught by QgisApp and display a msg on status bar)

◆ styleChanged

void QgsMapLayer::styleChanged ( )

signal

Signal emitted whenever a change affects the layer's style.

Ie this may be triggered by renderer changes, label style changes, or other style changes such as blend mode or layer opacity changes.

Note: added in QGIS 2.16

See also: rendererChanged()

◆ styleManager()

QgsMapLayerStyleManager * QgsMapLayer::styleManager ( ) const

Get access to the layer's style manager.

Style manager allows switching between multiple styles.

Note: added in 2.8

Definition at line 1705 of file qgsmaplayer.cpp.

◆ styleURI()

QString QgsMapLayer::styleURI ( )

virtual

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)

Returns: a QString with the style file name

See also: also loadNamedStyle () and saveNamedStyle ();

Definition at line 1049 of file qgsmaplayer.cpp.

◆ subLayers()

QStringList QgsMapLayer::subLayers ( ) const

virtual

Returns the sublayers of this layer (Useful for providers that manage their own layers, such as WMS)

Reimplemented in QgsRasterLayer.

Definition at line 997 of file qgsmaplayer.cpp.

◆ timestamp

virtual QDateTime QgsMapLayer::timestamp ( ) const

inlinevirtualslot

Time stamp of data source in the moment when data/metadata were loaded by provider.

Reimplemented in QgsRasterLayer.

Definition at line 651 of file qgsmaplayer.h.

◆ title()

QString QgsMapLayer::title ( ) const

inline

Get the title of the layer used by QGIS Server in GetCapabilities request.

Returns: the layer title

Definition at line 126 of file qgsmaplayer.h.

◆ toggleScaleBasedVisibility

void QgsMapLayer::toggleScaleBasedVisibility ( bool theVisibilityFlag )

slot

Accessor for the scale based visilibility flag.

Deprecated:: use setScaleBasedVisibility instead

Definition at line 961 of file qgsmaplayer.cpp.

◆ triggerRepaint

void QgsMapLayer::triggerRepaint ( )

slot

Will advice the map canvas (and any other interested party) that this layer requires to be repainted.

Will emit a repaintRequested() signal.

Note: in 2.6 function moved from vector/raster subclasses to QgsMapLayer

Definition at line 1715 of file qgsmaplayer.cpp.

◆ type()

QgsMapLayer::LayerType QgsMapLayer::type ( ) const

Get the type of the layer.

Returns: Integer matching a value in the QgsMapLayer::LayerType enum

Definition at line 99 of file qgsmaplayer.cpp.

◆ undoStack()

QUndoStack * QgsMapLayer::undoStack ( )

Return pointer to layer's undo stack.

Definition at line 1643 of file qgsmaplayer.cpp.

◆ undoStackStyles()

QUndoStack * QgsMapLayer::undoStackStyles ( )

Return pointer to layer's style undo stack.

Note: added in 2.16

Definition at line 1648 of file qgsmaplayer.cpp.

◆ writeCustomProperties()

void QgsMapLayer::writeCustomProperties	(	QDomNode &	layerNode,
		QDomDocument &	doc
	)		const

protected

Write custom properties to project file.

Definition at line 898 of file qgsmaplayer.cpp.

◆ writeLayerXML()

bool QgsMapLayer::writeLayerXML	(	QDomElement &	layerElement,
		QDomDocument &	document,
		const QString &	relativeBasePath = `QString()`
	)

Stores state in Dom node.

Parameters

layerElement	is a Dom element corresponding to ``maplayer'' tag
document	is a the dom document being written
relativeBasePath	base path for relative paths

Note

The Dom node corresponds to a Dom document project file XML element to be written by QgsProject.

This, in turn, calls writeXml(), which is over-rideable by sub-classes so that they can write their own specific state to the given Dom node.

Invoked by QgsProject::write().

Returns: true if successful

Definition at line 542 of file qgsmaplayer.cpp.

◆ writeStyle()

bool QgsMapLayer::writeStyle	(	QDomNode &	node,
		QDomDocument &	doc,
		QString &	errorMessage
	)		const

virtual

Write 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

Returns: true in case of success.

Note: added in 2.16; To be implemented in subclasses. Default implementation does nothing and returns false.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 1634 of file qgsmaplayer.cpp.

◆ writeStyleManager()

void QgsMapLayer::writeStyleManager	(	QDomNode &	layerNode,
		QDomDocument &	doc
	)		const

protected

Write style manager's configuration (if exists).

To be called by subclasses.

Definition at line 912 of file qgsmaplayer.cpp.

◆ writeSymbology()

virtual bool QgsMapLayer::writeSymbology	(	QDomNode &	node,
		QDomDocument &	doc,
		QString &	errorMessage
	)		const

pure virtual

Write the symbology for the layer into the docment 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

Returns: true in case of success.

Implemented in QgsVectorLayer, and QgsRasterLayer.

◆ writeXml()

bool QgsMapLayer::writeXml	(	QDomNode &	layer_node,
		QDomDocument &	document
	)

protectedvirtual

Called by writeLayerXML(), used by children to write state specific to them to project files.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 883 of file qgsmaplayer.cpp.

Member Data Documentation

◆ mAbstract

QString QgsMapLayer::mAbstract

protected

Description of the layer.

Definition at line 784 of file qgsmaplayer.h.

◆ mAttribution

QString QgsMapLayer::mAttribution

protected

Attribution of the layer.

Definition at line 792 of file qgsmaplayer.h.

◆ mAttributionUrl

QString QgsMapLayer::mAttributionUrl

protected

Definition at line 793 of file qgsmaplayer.h.

◆ mDataSource

QString QgsMapLayer::mDataSource

protected

Data source description string, varies by layer type.

Definition at line 771 of file qgsmaplayer.h.

◆ mDataUrl

QString QgsMapLayer::mDataUrl

protected

DataUrl of the layer.

Definition at line 788 of file qgsmaplayer.h.

◆ mDataUrlFormat

QString QgsMapLayer::mDataUrlFormat

protected

Definition at line 789 of file qgsmaplayer.h.

◆ mError

QgsError QgsMapLayer::mError

protected

Error.

Definition at line 805 of file qgsmaplayer.h.

◆ mExtent

QgsRectangle QgsMapLayer::mExtent

protected

Extent of the layer.

Definition at line 765 of file qgsmaplayer.h.

◆ mKeywordList

QString QgsMapLayer::mKeywordList

protected

Definition at line 785 of file qgsmaplayer.h.

◆ mLayerName

QString QgsMapLayer::mLayerName

protected

Name of the layer - used for display.

Definition at line 774 of file qgsmaplayer.h.

◆ mLayerOrigName

QString QgsMapLayer::mLayerOrigName

protected

Original name of the layer.

Definition at line 778 of file qgsmaplayer.h.

◆ mLegendUrl

QString QgsMapLayer::mLegendUrl

protected

WMS legend.

Definition at line 801 of file qgsmaplayer.h.

◆ mLegendUrlFormat

QString QgsMapLayer::mLegendUrlFormat

protected

Definition at line 802 of file qgsmaplayer.h.

◆ mMetadataUrl

QString QgsMapLayer::mMetadataUrl

protected

MetadataUrl of the layer.

Definition at line 796 of file qgsmaplayer.h.

◆ mMetadataUrlFormat

QString QgsMapLayer::mMetadataUrlFormat

protected

Definition at line 798 of file qgsmaplayer.h.

◆ mMetadataUrlType

QString QgsMapLayer::mMetadataUrlType

protected

Definition at line 797 of file qgsmaplayer.h.

◆ mShortName

QString QgsMapLayer::mShortName

protected

Definition at line 780 of file qgsmaplayer.h.

◆ mTitle

QString QgsMapLayer::mTitle

protected

Definition at line 781 of file qgsmaplayer.h.

◆ mValid

bool QgsMapLayer::mValid

protected

Indicates if the layer is valid and can be drawn.

Definition at line 768 of file qgsmaplayer.h.

Property Documentation

◆ name

QString QgsMapLayer::name

readwrite

Read property of QString layerName.

Definition at line 53 of file qgsmaplayer.h.

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

/tmp/buildd/qgis-2.18.21+99unstable/src/core/qgsmaplayer.h
/tmp/buildd/qgis-2.18.21+99unstable/src/core/qgsmaplayer.cpp

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Properties

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ LayerType

Constructor & Destructor Documentation

◆ QgsMapLayer()

◆ ~QgsMapLayer()

Member Function Documentation

◆ abstract()

◆ appendError()

◆ asLayerDefinition()

◆ attribution()

◆ attributionUrl()

◆ blendMode()

◆ blendModeChanged

◆ cacheImage()

◆ capitaliseLayerName()

◆ clearCacheImage

◆ configChanged

◆ createMapRenderer()

◆ crs()

◆ customProperty()

◆ dataChanged

◆ dataUrl()

◆ dataUrlFormat()

◆ draw()

◆ drawingProgress

◆ drawLabels()

◆ emitStyleChanged

◆ error()

◆ exportNamedStyle()

◆ exportSldStyle()

◆ extent()

◆ fromLayerDefinition()

◆ fromLayerDefinitionFile()

◆ hasScaleBasedVisibility()

◆ id()

◆ importNamedStyle()

◆ invalidTransformInput

◆ isEditable()

◆ isInScaleRange()

◆ isSpatial()

◆ isValid()

◆ keywordList()

◆ lastError()

◆ lastErrorTitle()

◆ layerCrsChanged

◆ layerNameChanged

◆ legend()

◆ legendChanged

◆ legendUrl()

◆ legendUrlFormat()

◆ loadDefaultStyle()

◆ loadNamedStyle()

◆ loadNamedStyleFromDb()

◆ loadSldStyle()

◆ maximumScale()

◆ metadata

◆ metadataUrl()

◆ metadataUrlFormat()

◆ metadataUrlType()

◆ minimumScale()

◆ name()

◆ nameChanged

◆ onCacheImageDelete()

◆ originalName()

◆ publicSource()

◆ readCustomProperties()

◆ readLayerXML()

◆ readOnly()

◆ readSld()

◆ readStyle()