QGIS API Documentation  3.37.0-Master (a5b4d9743e8)
qgsmapdecoration.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsmapdecoration.h
3  ----------------
4  begin : April 2017
5  copyright : (C) 2017 by Mathieu Pellerin
6  email : nirvn dot asia at gmail dot com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #ifndef QGSMAPDECORATION_H
19 #define QGSMAPDECORATION_H
20 
21 #include "qgis_core.h"
22 #include <QString>
23 
24 class QgsMapSettings;
25 class QgsRenderContext;
26 
33 class CORE_EXPORT QgsMapDecoration
34 {
35 
36  public:
37 
41  QgsMapDecoration() = default;
42 
43  virtual ~QgsMapDecoration() = default;
44 
48  virtual void render( const QgsMapSettings &mapSettings, QgsRenderContext &context ) = 0;
49 
54  const QString displayName() const { return mDisplayName; }
55 
61  virtual bool hasFixedMapPosition() const { return false; }
62 
63  protected:
64 
69  void setDisplayName( const QString &name ) { mDisplayName = name; }
70 
71  private:
72 
73  QString mDisplayName;
74 
75 };
76 
77 #endif //QGSMAPDECORATION_H
Interface for map decorations.
virtual bool hasFixedMapPosition() const
Returns true if the decoration is attached to a fixed map position (e.g grid, layout extent),...
const QString displayName() const
Returns the map decoration display name.
virtual void render(const QgsMapSettings &mapSettings, QgsRenderContext &context)=0
Renders a map decoration.
virtual ~QgsMapDecoration()=default
QgsMapDecoration()=default
Constructor for QgsMapDecoration.
void setDisplayName(const QString &name)
Sets the map decoration display name.
The QgsMapSettings class contains configuration for rendering of the map.
Contains information about the context of a rendering operation.