QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsannotationmanager.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsannotationmanager.h
3 ----------------------
4 Date : January 2017
5 Copyright : (C) 2017 Nyall Dawson
6 Email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSANNOTATIONMANAGER_H
17#define QGSANNOTATIONMANAGER_H
18
19#include "qgis_core.h"
20#include "qgis.h"
21#include <QObject>
22#include <QDomElement>
23
25class QgsProject;
26class QgsAnnotation;
28
43class CORE_EXPORT QgsAnnotationManager : public QObject
44{
45 Q_OBJECT
46
47 public:
48
53 explicit QgsAnnotationManager( QgsProject *project SIP_TRANSFERTHIS = nullptr );
54
55 ~QgsAnnotationManager() override;
56
63 bool addAnnotation( QgsAnnotation *annotation SIP_TRANSFER );
64
74 bool removeAnnotation( QgsAnnotation *annotation );
75
80 void clear();
81
86 QList< QgsAnnotation * > annotations() const;
87
94 QList< QgsAnnotation * > cloneAnnotations() const SIP_FACTORY;
95
101 bool readXml( const QDomElement &element, const QgsReadWriteContext &context );
102
107 QDomElement writeXml( QDomDocument &doc, const QgsReadWriteContext &context ) const;
108
118 bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
119
120 signals:
121
123 void annotationAdded( QgsAnnotation *annotation );
124
127
130
131 private:
132
133 QgsProject *mProject = nullptr;
134
135 QList< QgsAnnotation * > mAnnotations;
136
137 void createAnnotationFromXml( const QDomElement &element, const QgsReadWriteContext &context );
138
139};
140
141#endif // QGSANNOTATIONMANAGER_H
Manages storage of a set of QgsAnnotation annotation objects.
void annotationRemoved()
Emitted when an annotation was removed from the manager.
void annotationAboutToBeRemoved(QgsAnnotation *annotation)
Emitted when an annotation is about to be removed from the manager.
void annotationAdded(QgsAnnotation *annotation)
Emitted when a annotation has been added to the manager.
Abstract base class for annotation items which are drawn over a map.
Definition: qgsannotation.h:53
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:107
The class is used as a container of context for various read/write operations on other objects.
An interface for classes which can visit style entity (e.g.
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:53
#define SIP_TRANSFER
Definition: qgis_sip.h:36
#define SIP_FACTORY
Definition: qgis_sip.h:76