QGIS API Documentation  2.4.0-Chugiak
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | List of all members
QgsLabelingEngineInterface Class Referenceabstract

Labeling engine interface. More...

#include <qgsmaprenderer.h>

Inheritance diagram for QgsLabelingEngineInterface:
Inheritance graph
[legend]

Public Member Functions

virtual ~QgsLabelingEngineInterface ()
 
virtual Q_DECL_DEPRECATED void init (QgsMapRenderer *mp)=0
 called when we're going to start with rendering More...
 
virtual void init (const QgsMapSettings &mapSettings)=0
 called when we're going to start with rendering More...
 
virtual bool willUseLayer (QgsVectorLayer *layer)=0
 called to find out whether the layer is used for labeling More...
 
virtual void clearActiveLayers ()=0
 clears all PAL layer settings for registered layers More...
 
virtual void clearActiveLayer (const QString &layerID)=0
 clears data defined objects from PAL layer settings for a registered layer More...
 
virtual int prepareLayer (QgsVectorLayer *layer, QStringList &attrNames, QgsRenderContext &ctx)=0
 called when starting rendering of a layer More...
 
virtual QgsPalLayerSettingslayer (const QString &layerName)=0
 returns PAL layer settings for a registered layer More...
 
virtual int addDiagramLayer (QgsVectorLayer *layer, const QgsDiagramLayerSettings *s)
 adds a diagram layer to the labeling engine More...
 
virtual void registerFeature (const QString &layerID, QgsFeature &feat, const QgsRenderContext &context=QgsRenderContext())=0
 called for every feature More...
 
virtual void registerDiagramFeature (const QString &layerID, QgsFeature &feat, const QgsRenderContext &context=QgsRenderContext())
 called for every diagram feature More...
 
virtual void drawLabeling (QgsRenderContext &context)=0
 called when the map is drawn and labels should be placed More...
 
virtual void exit ()=0
 called when we're done with rendering More...
 
virtual Q_DECL_DEPRECATED
QList< QgsLabelPosition
labelsAtPosition (const QgsPoint &p)=0
 return infos about labels at a given (map) position More...
 
virtual Q_DECL_DEPRECATED
QList< QgsLabelPosition
labelsWithinRect (const QgsRectangle &r)=0
 return infos about labels within a given (map) rectangle More...
 
virtual
QgsLabelingEngineInterface
clone ()=0
 called when passing engine among map renderers More...
 

Detailed Description

Labeling engine interface.

Note
Added in QGIS v1.4

Definition at line 69 of file qgsmaprenderer.h.

Constructor & Destructor Documentation

virtual QgsLabelingEngineInterface::~QgsLabelingEngineInterface ( )
inlinevirtual

Definition at line 73 of file qgsmaprenderer.h.

Member Function Documentation

virtual int QgsLabelingEngineInterface::addDiagramLayer ( QgsVectorLayer layer,
const QgsDiagramLayerSettings s 
)
inlinevirtual

adds a diagram layer to the labeling engine

Reimplemented in QgsPalLabeling.

Definition at line 95 of file qgsmaprenderer.h.

Referenced by QgsVectorLayerRenderer::prepareDiagrams().

virtual void QgsLabelingEngineInterface::clearActiveLayer ( const QString &  layerID)
pure virtual

clears data defined objects from PAL layer settings for a registered layer

Note
: this method was added in version 1.9

Implemented in QgsPalLabeling.

virtual void QgsLabelingEngineInterface::clearActiveLayers ( )
pure virtual

clears all PAL layer settings for registered layers

Note
: this method was added in version 1.9

Implemented in QgsPalLabeling.

virtual QgsLabelingEngineInterface* QgsLabelingEngineInterface::clone ( )
pure virtual

called when passing engine among map renderers

Implemented in QgsPalLabeling.

virtual void QgsLabelingEngineInterface::drawLabeling ( QgsRenderContext context)
pure virtual

called when the map is drawn and labels should be placed

Implemented in QgsPalLabeling.

Referenced by QgsMapRenderer::render().

virtual void QgsLabelingEngineInterface::exit ( )
pure virtual

called when we're done with rendering

Implemented in QgsPalLabeling.

Referenced by QgsMapRenderer::render().

virtual Q_DECL_DEPRECATED void QgsLabelingEngineInterface::init ( QgsMapRenderer mp)
pure virtual

called when we're going to start with rendering

Deprecated:
since 2.4 - use override with QgsMapSettings

Implemented in QgsPalLabeling.

Referenced by QgsMapRenderer::render().

virtual void QgsLabelingEngineInterface::init ( const QgsMapSettings mapSettings)
pure virtual

called when we're going to start with rendering

Implemented in QgsPalLabeling.

virtual Q_DECL_DEPRECATED QList<QgsLabelPosition> QgsLabelingEngineInterface::labelsAtPosition ( const QgsPoint p)
pure virtual

return infos about labels at a given (map) position

Note
: this method was added in version 1.7
Deprecated:
since 2.4 - use takeResults() and methods of QgsLabelingResults

Implemented in QgsPalLabeling.

virtual Q_DECL_DEPRECATED QList<QgsLabelPosition> QgsLabelingEngineInterface::labelsWithinRect ( const QgsRectangle r)
pure virtual

return infos about labels within a given (map) rectangle

Note
: this method was added in version 1.9
Deprecated:
since 2.4 - use takeResults() and methods of QgsLabelingResults

Implemented in QgsPalLabeling.

virtual QgsPalLayerSettings& QgsLabelingEngineInterface::layer ( const QString &  layerName)
pure virtual

returns PAL layer settings for a registered layer

Note
: this method was added in version 1.9

Implemented in QgsPalLabeling.

Referenced by QgsVectorLayerRenderer::prepareLabeling().

virtual int QgsLabelingEngineInterface::prepareLayer ( QgsVectorLayer layer,
QStringList &  attrNames,
QgsRenderContext ctx 
)
pure virtual

called when starting rendering of a layer

Note
: this method was added in version 1.6

Implemented in QgsPalLabeling.

Referenced by QgsVectorLayerRenderer::prepareLabeling().

virtual void QgsLabelingEngineInterface::registerDiagramFeature ( const QString &  layerID,
QgsFeature feat,
const QgsRenderContext context = QgsRenderContext() 
)
inlinevirtual

called for every diagram feature

Reimplemented in QgsPalLabeling.

Definition at line 100 of file qgsmaprenderer.h.

Referenced by QgsVectorLayerRenderer::drawRendererV2(), and QgsVectorLayerRenderer::drawRendererV2Levels().

virtual void QgsLabelingEngineInterface::registerFeature ( const QString &  layerID,
QgsFeature feat,
const QgsRenderContext context = QgsRenderContext() 
)
pure virtual
virtual bool QgsLabelingEngineInterface::willUseLayer ( QgsVectorLayer layer)
pure virtual

called to find out whether the layer is used for labeling

Implemented in QgsPalLabeling.


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