QGIS API Documentation  2.17.0-Master (6f7b933)
Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Properties | List of all members
QgsMapLayer Class Referenceabstract

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

#include <qgsmaplayer.h>

Inheritance diagram for QgsMapLayer:
Inheritance graph
[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 QImagecacheImage ()
 
virtual QgsMapLayerRenderercreateMapRenderer (QgsRenderContext &rendererContext)
 Return new instance of QgsMapLayerRenderer that will be used for rendering of given context. More...
 
const QgsCoordinateReferenceSystemcrs () 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 ()
 
QgsMapLayerLegendlegend () 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)
 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...
 
QgsMapLayerStyleManagerstyleManager () 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...
 
QUndoStackundoStack ()
 Return pointer to layer's undo stack. More...
 
QUndoStackundoStackStyles ()
 Return pointer to layer's style undo stack. More...
 
bool writeLayerXML (QDomElement &layerElement, QDomDocument &document, const QString &relativeBasePath=QString::null)
 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)
 
QObjectchild (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< QByteArraydynamicPropertyNames () const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
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 QMetaObjectmetaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObjectparent () 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)
 
QThreadthread () const
 

Static Public Member Functions

static QDomDocument asLayerDefinition (const QList< QgsMapLayer * > &layers, const QString &relativeBasePath=QString::null)
 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)
 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
 
QObjectsender () 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

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::LayerType  type = VectorLayer,
const QString lyrname = QString::null,
const QString source = QString::null 
)

Constructor.

Parameters
typeType of layer as defined in QgsMapLayer::LayerType enum
lyrnameDisplay Name of the layer
sourcedatasource of layer

Definition at line 54 of file qgsmaplayer.cpp.

QgsMapLayer::~QgsMapLayer ( )
virtual

Destructor.

Definition at line 91 of file qgsmaplayer.cpp.

Member Function Documentation

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.

void QgsMapLayer::appendError ( const QgsErrorMessage theMessage)
inlineprotected

Add error message.

Definition at line 759 of file qgsmaplayer.h.

QDomDocument QgsMapLayer::asLayerDefinition ( const QList< QgsMapLayer * > &  layers,
const QString relativeBasePath = QString::null 
)
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 800 of file qgsmaplayer.cpp.

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.

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.

QPainter::CompositionMode QgsMapLayer::blendMode ( ) const

Returns the current blending mode for a layer.

Read blend mode for layer.

Definition at line 159 of file qgsmaplayer.cpp.

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

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

Q_DECL_DEPRECATED QImage* QgsMapLayer::cacheImage ( )
inline
Deprecated:
since 2.4 - returns nullptr

Definition at line 534 of file qgsmaplayer.h.

QString QgsMapLayer::capitaliseLayerName ( const QString name)
static

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

Definition at line 1030 of file qgsmaplayer.cpp.

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 1701 of file qgsmaplayer.cpp.

void QgsMapLayer::configChanged ( )
signal

Emitted whenever the configuration is changed.

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

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.

const QgsCoordinateReferenceSystem & QgsMapLayer::crs ( ) const

Returns layer's spatial reference system.

Note
This was introduced in QGIS 1.4

Definition at line 1011 of file qgsmaplayer.cpp.

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 1650 of file qgsmaplayer.cpp.

void QgsMapLayer::dataChanged ( )
signal

Data of layer changed.

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.

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.

bool QgsMapLayer::draw ( QgsRenderContext rendererContext)
virtual

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

Parameters
rendererContextdescribes the extents, resolumon etc. that should be used when rendering the layer.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 164 of file qgsmaplayer.cpp.

Q_DECL_DEPRECATED void QgsMapLayer::drawingProgress ( int  theProgress,
int  theTotalSteps 
)
signal
Deprecated:
in 2.4 - not emitted anymore
void QgsMapLayer::drawLabels ( QgsRenderContext rendererContext)
virtual

Draw labels.

Todo:
to be removed: used only in vector layers

Reimplemented in QgsVectorLayer.

Definition at line 170 of file qgsmaplayer.cpp.

void QgsMapLayer::emitStyleChanged ( )
slot

Triggers an emission of the styleChanged() signal.

Note
added in QGIS 2.16

Definition at line 1716 of file qgsmaplayer.cpp.

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 376 of file qgsmaplayer.h.

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

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

Parameters
docthe target QDomDocument
errorMsgthis QString will be initialized on error during the execution of writeSymbology

Definition at line 1254 of file qgsmaplayer.cpp.

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

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

Parameters
docthe target QDomDocument
errorMsgthis QString will be initialized on error during the execution of writeSymbology

Definition at line 1453 of file qgsmaplayer.cpp.

QgsRectangle QgsMapLayer::extent ( )
virtual

Return the extent of the layer.

Reimplemented in QgsVectorLayer.

Definition at line 145 of file qgsmaplayer.cpp.

QList< QgsMapLayer * > QgsMapLayer::fromLayerDefinition ( QDomDocument document,
bool  addToRegistry = false,
bool  addToLegend = false 
)
static

Creates a new layer from a layer defininition document.

Definition at line 816 of file qgsmaplayer.cpp.

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

Definition at line 857 of file qgsmaplayer.cpp.

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 962 of file qgsmaplayer.cpp.

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 103 of file qgsmaplayer.cpp.

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

Import the properties of this layer from a QDomDocument.

Parameters
docsource QDomDocument
errorMsgthis QString will be initialized on error during the execution of readSymbology
Returns
true on success
Note
added in 2.8

Definition at line 1203 of file qgsmaplayer.cpp.

void QgsMapLayer::invalidTransformInput ( )
virtualslot

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

Definition at line 927 of file qgsmaplayer.cpp.

bool QgsMapLayer::isEditable ( ) const
virtual

True if the layer can be edited.

Reimplemented in QgsVectorLayer.

Definition at line 1662 of file qgsmaplayer.cpp.

bool QgsMapLayer::isInScaleRange ( double  scale) const

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

Parameters
scalescale 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 952 of file qgsmaplayer.cpp.

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.

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 921 of file qgsmaplayer.cpp.

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.

QString QgsMapLayer::lastError ( )
virtual
Deprecated:
since 2.4 - returns empty string

Definition at line 939 of file qgsmaplayer.cpp.

QString QgsMapLayer::lastErrorTitle ( )
virtual
Deprecated:
since 2.4 - returns empty string

Definition at line 934 of file qgsmaplayer.cpp.

void QgsMapLayer::layerCrsChanged ( )
signal

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

Q_DECL_DEPRECATED void QgsMapLayer::layerNameChanged ( )
signal

Emit a signal that the layer name has been changed.

Deprecated:
since 2.16 use nameChanged() instead
QgsMapLayerLegend * QgsMapLayer::legend ( ) const

Can be null.

Note
added in 2.6

Definition at line 1691 of file qgsmaplayer.cpp.

void QgsMapLayer::legendChanged ( )
signal

Signal emitted when legend of the layer has changed.

Note
added in 2.6
QString QgsMapLayer::legendUrl ( ) const
inline

Definition at line 529 of file qgsmaplayer.h.

QString QgsMapLayer::legendUrlFormat ( ) const
inline

Definition at line 531 of file qgsmaplayer.h.

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
theResultFlaga 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 1097 of file qgsmaplayer.cpp.

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.
theResultFlaga 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 1147 of file qgsmaplayer.cpp.

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

Definition at line 1102 of file qgsmaplayer.cpp.

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

Definition at line 1557 of file qgsmaplayer.cpp.

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 988 of file qgsmaplayer.cpp.

QString QgsMapLayer::metadata ( )
virtualslot

Obtain Metadata for this layer.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 1711 of file qgsmaplayer.cpp.

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.

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.

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.

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 972 of file qgsmaplayer.cpp.

QString QgsMapLayer::name ( ) const

Get the display name of the layer.

Returns
the layer name
void QgsMapLayer::nameChanged ( )
signal

Emitted when the name has been changed.

Note
added in 2.16
virtual Q_DECL_DEPRECATED void QgsMapLayer::onCacheImageDelete ( )
inlinevirtual
Deprecated:
since 2.4 - does nothing

Definition at line 538 of file qgsmaplayer.h.

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.

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 132 of file qgsmaplayer.cpp.

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

Read custom properties from project file.

Parameters
layerNodenote to read from
keyStartsWithreads only properties starting with the specified string (or all if the string is empty)

Definition at line 889 of file qgsmaplayer.cpp.

bool QgsMapLayer::readLayerXML ( const QDomElement layerElement)

Sets state from Dom document.

Parameters
layerElementThe Dom element corresponding to ``maplayer'' tag
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 175 of file qgsmaplayer.cpp.

bool QgsMapLayer::readOnly ( ) const
inline

Returns if this layer is read only.

Definition at line 246 of file qgsmaplayer.h.

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

Reimplemented in QgsVectorLayer.

Definition at line 480 of file qgsmaplayer.h.

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

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

Parameters
nodenode that will contain the style definition for this layer.
errorMessagereference 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 1618 of file qgsmaplayer.cpp.

void QgsMapLayer::readStyleManager ( const QDomNode layerNode)
protected

Read style manager's configuration (if any).

To be called by subclasses.

Definition at line 899 of file qgsmaplayer.cpp.

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

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

Parameters
nodenode that will contain the symbology definition for this layer.
errorMessagereference to string that will be updated with any error messages
Returns
true in case of success.

Implemented in QgsVectorLayer, and QgsRasterLayer.

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 528 of file qgsmaplayer.cpp.

void QgsMapLayer::recalculateExtents ( )
signal

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

virtual void QgsMapLayer::reload ( )
inlinevirtual

Synchronises with changes in the datasource.

Reimplemented in QgsVectorLayer, and QgsRasterLayer.

Definition at line 250 of file qgsmaplayer.h.

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 1655 of file qgsmaplayer.cpp.

void QgsMapLayer::rendererChanged ( )
signal

Signal emitted when renderer is changed.

See also
styleChanged()
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.

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
theResultFlaga 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 1303 of file qgsmaplayer.cpp.

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
theURIthe 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.
theResultFlaga 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 1308 of file qgsmaplayer.cpp.

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

Definition at line 1492 of file qgsmaplayer.cpp.

void QgsMapLayer::screenUpdateRequested ( )
signal
Note
Deprecated in 2.4 and not emitted anymore
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.

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.

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.

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

Set the blending mode used for rendering a layer.

Write blend mode for layer.

Definition at line 151 of file qgsmaplayer.cpp.

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

Definition at line 1672 of file qgsmaplayer.cpp.

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

Sets layer's spatial reference system.

Definition at line 1016 of file qgsmaplayer.cpp.

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 1645 of file qgsmaplayer.cpp.

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.

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.

void QgsMapLayer::setError ( const QgsError theError)
inlineprotected

Set error message.

Definition at line 761 of file qgsmaplayer.h.

void QgsMapLayer::setExtent ( const QgsRectangle rect)
protectedvirtual

Set the extent.

Reimplemented in QgsVectorLayer, and QgsPluginLayer.

Definition at line 1721 of file qgsmaplayer.cpp.

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.

void QgsMapLayer::setLayerName ( const QString name)

Set the display name of the layer.

Parameters
nameNew name for the layer
Deprecated:
Since 2.16, use setName instead

Definition at line 108 of file qgsmaplayer.cpp.

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 998 of file qgsmaplayer.cpp.

void QgsMapLayer::setLegend ( QgsMapLayerLegend legend)

Assign a legend controller to the map layer.

The object will be responsible for providing legend items.

Parameters
legendTakes ownership of the object. Can be null pointer
Note
added in 2.6

Definition at line 1677 of file qgsmaplayer.cpp.

void QgsMapLayer::setLegendUrl ( const QString legendUrl)
inline

Definition at line 528 of file qgsmaplayer.h.

void QgsMapLayer::setLegendUrlFormat ( const QString legendUrlFormat)
inline

Definition at line 530 of file qgsmaplayer.h.

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
theMaxScalemaximum scale denominator at which the layer should render
See also
maximumScale
setMinimumScale
setScaleBasedVisibility

Definition at line 978 of file qgsmaplayer.cpp.

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.

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.

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.

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
theMinScaleminimum scale denominator at which the layer should render
See also
minimumScale
setMaximumScale
setScaleBasedVisibility

Definition at line 967 of file qgsmaplayer.cpp.

void QgsMapLayer::setName ( const QString name)

Set the display name of the layer.

Parameters
nameNew name for the layer
Note
added in 2.16

Definition at line 113 of file qgsmaplayer.cpp.

void QgsMapLayer::setScaleBasedVisibility ( const bool  enabled)
slot

Sets whether scale based visibility is enabled for the layer.

Parameters
enabledset to true to enable scale based visibility
See also
setMinimumScale
setMaximumScale
scaleBasedVisibility

Definition at line 983 of file qgsmaplayer.cpp.

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.

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

Set the visibility of the given sublayer name.

Reimplemented in QgsRasterLayer.

Definition at line 1004 of file qgsmaplayer.cpp.

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.

void QgsMapLayer::setValid ( bool  valid)
protected

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

Definition at line 1667 of file qgsmaplayer.cpp.

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.

QString QgsMapLayer::source ( ) const

Returns the source for the layer.

Definition at line 140 of file qgsmaplayer.cpp.

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)

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()
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 1696 of file qgsmaplayer.cpp.

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 1045 of file qgsmaplayer.cpp.

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 993 of file qgsmaplayer.cpp.

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 650 of file qgsmaplayer.h.

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.

void QgsMapLayer::toggleScaleBasedVisibility ( bool  theVisibilityFlag)
slot

Accessor for the scale based visilibility flag.

Deprecated:
use setScaleBasedVisibility instead

Definition at line 957 of file qgsmaplayer.cpp.

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 1706 of file qgsmaplayer.cpp.

QgsMapLayer::LayerType QgsMapLayer::type ( ) const

Get the type of the layer.

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

Definition at line 97 of file qgsmaplayer.cpp.

QUndoStack * QgsMapLayer::undoStack ( )

Return pointer to layer's undo stack.

Definition at line 1634 of file qgsmaplayer.cpp.

QUndoStack * QgsMapLayer::undoStackStyles ( )

Return pointer to layer's style undo stack.

Note
added in 2.16

Definition at line 1639 of file qgsmaplayer.cpp.

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

Write custom properties to project file.

Definition at line 894 of file qgsmaplayer.cpp.

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

Stores state in Dom node.

Parameters
layerElementis a Dom element corresponding to ``maplayer'' tag
documentis a the dom document being written
relativeBasePathbase 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 538 of file qgsmaplayer.cpp.

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

Write just the style information for the layer into the document.

Parameters
nodethe node that will have the style element added to it.
docthe document that will have the QDomNode added.
errorMessagereference 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 1625 of file qgsmaplayer.cpp.

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

Write style manager's configuration (if exists).

To be called by subclasses.

Definition at line 908 of file qgsmaplayer.cpp.

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

Write the symbology for the layer into the docment provided.

Parameters
nodethe node that will have the style element added to it.
docthe document that will have the QDomNode added.
errorMessagereference to string that will be updated with any error messages
Returns
true in case of success.

Implemented in QgsVectorLayer, and QgsRasterLayer.

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 879 of file qgsmaplayer.cpp.

Member Data Documentation

QString QgsMapLayer::mAbstract
protected

Description of the layer.

Definition at line 783 of file qgsmaplayer.h.

QString QgsMapLayer::mAttribution
protected

Attribution of the layer.

Definition at line 791 of file qgsmaplayer.h.

QString QgsMapLayer::mAttributionUrl
protected

Definition at line 792 of file qgsmaplayer.h.

QString QgsMapLayer::mDataSource
protected

Data source description string, varies by layer type.

Definition at line 770 of file qgsmaplayer.h.

QString QgsMapLayer::mDataUrl
protected

DataUrl of the layer.

Definition at line 787 of file qgsmaplayer.h.

QString QgsMapLayer::mDataUrlFormat
protected

Definition at line 788 of file qgsmaplayer.h.

QgsError QgsMapLayer::mError
protected

Error.

Definition at line 804 of file qgsmaplayer.h.

QgsRectangle QgsMapLayer::mExtent
protected

Extent of the layer.

Definition at line 764 of file qgsmaplayer.h.

QString QgsMapLayer::mKeywordList
protected

Definition at line 784 of file qgsmaplayer.h.

QString QgsMapLayer::mLayerName
protected

Name of the layer - used for display.

Definition at line 773 of file qgsmaplayer.h.

QString QgsMapLayer::mLayerOrigName
protected

Original name of the layer.

Definition at line 777 of file qgsmaplayer.h.

QString QgsMapLayer::mLegendUrl
protected

WMS legend.

Definition at line 800 of file qgsmaplayer.h.

QString QgsMapLayer::mLegendUrlFormat
protected

Definition at line 801 of file qgsmaplayer.h.

QString QgsMapLayer::mMetadataUrl
protected

MetadataUrl of the layer.

Definition at line 795 of file qgsmaplayer.h.

QString QgsMapLayer::mMetadataUrlFormat
protected

Definition at line 797 of file qgsmaplayer.h.

QString QgsMapLayer::mMetadataUrlType
protected

Definition at line 796 of file qgsmaplayer.h.

QString QgsMapLayer::mShortName
protected

Definition at line 779 of file qgsmaplayer.h.

QString QgsMapLayer::mTitle
protected

Definition at line 780 of file qgsmaplayer.h.

bool QgsMapLayer::mValid
protected

Indicates if the layer is valid and can be drawn.

Definition at line 767 of file qgsmaplayer.h.

Property Documentation

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: