QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
qgsreport.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsreport.h
3 ---------------------------
4 begin : December 2017
5 copyright : (C) 2017 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************/
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16#ifndef QGSREPORT_H
17#define QGSREPORT_H
18
19#include "qgis_core.h"
22
24
25// This is not considered stable API - it is exposed to python bindings only for unit testing!
26
40class CORE_EXPORT QgsReport : public QObject, public QgsAbstractReportSection, public QgsMasterLayoutInterface
41{
42
43 Q_OBJECT
44
45 public:
46
53 QgsReport( QgsProject *project );
54
56 QString type() const override { return QStringLiteral( "SectionReport" ); }
57 QString description() const override { return QObject::tr( "Report" ); }
58 QIcon icon() const override;
59 QgsProject *layoutProject() const override { return mProject; }
60 QgsReport *clone() const override SIP_FACTORY;
61 QString name() const override { return mName; }
62 void setName( const QString &name ) override;
63 QDomElement writeLayoutXml( QDomDocument &document, const QgsReadWriteContext &context ) const override;
64 bool readLayoutXml( const QDomElement &layoutElement, const QDomDocument &document, const QgsReadWriteContext &context ) override;
65 void updateSettings() override;
66 bool layoutAccept( QgsStyleEntityVisitorInterface *visitor ) const override;
67
68 signals:
69
74 void nameChanged( const QString &name );
75
76 private:
77
78 QgsProject *mProject = nullptr;
79 QString mName;
80
81};
82
84
85#endif //QGSREPORT_H
Interface for master layout type objects, such as print layouts and reports.
virtual QgsProject * layoutProject() const =0
The project associated with the layout.
virtual QDomElement writeLayoutXml(QDomDocument &document, const QgsReadWriteContext &context) const =0
Returns the layout's state encapsulated in a DOM element.
virtual QIcon icon() const =0
Returns an icon for the layout.
virtual QgsMasterLayoutInterface::Type layoutType() const =0
Returns the master layout type.
virtual void updateSettings()=0
Refreshes the layout when global layout related options change.
virtual QgsMasterLayoutInterface * clone() const =0
Creates a clone of the layout.
virtual bool layoutAccept(QgsStyleEntityVisitorInterface *visitor) const
Accepts the specified style entity visitor, causing it to visit all style entities associated with th...
virtual void setName(const QString &name)=0
Sets the layout's name.
virtual bool readLayoutXml(const QDomElement &layoutElement, const QDomDocument &document, const QgsReadWriteContext &context)=0
Sets the layout's state from a DOM element.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:104
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_FACTORY
Definition: qgis_sip.h:76