QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgslayoutgridsettings.h
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutgridsettings.h
3 -----------------------
4 begin : July 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 QGSLAYOUTGRIDSETTINGS_H
17#define QGSLAYOUTGRIDSETTINGS_H
18
19#include "qgis_core.h"
21#include "qgslayoutpoint.h"
24
25#include <QPen>
26#include <QString>
27
28using namespace Qt::StringLiterals;
29
30class QgsLayout;
32
39{
40
41 public:
42
50
55
56 QString stringType() const override { return u"LayoutGrid"_s; }
57 QgsLayout *layout() override;
58
64 void setResolution( QgsLayoutMeasurement resolution );
65
71 QgsLayoutMeasurement resolution() const { return mGridResolution;}
72
78 void setOffset( const QgsLayoutPoint &offset );
79
85 QgsLayoutPoint offset() const { return mGridOffset; }
86
92 void setPen( const QPen &pen ) { mGridPen = pen; }
93
99 QPen pen() const { return mGridPen; }
100
106 void setStyle( const Style style ) { mGridStyle = style; }
107
113 Style style() const { return mGridStyle; }
114
118 void loadFromSettings();
119
124 bool writeXml( QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context ) const override;
125
130 bool readXml( const QDomElement &gridElement, const QDomDocument &document, const QgsReadWriteContext &context ) override;
131
132 private:
133
134 // Used for 'collapsing' undo commands
135 enum UndoCommand
136 {
137 UndoGridResolution = 1,
138 UndoGridOffset,
139 };
140
141 QgsLayoutMeasurement mGridResolution;
142 QgsLayoutPoint mGridOffset;
143 QPen mGridPen;
144 Style mGridStyle = StyleLines;
145 QgsLayout *mLayout = nullptr;
146
147};
148
149#endif //QGSLAYOUTGRIDSETTINGS_H
Contains settings relating to the appearance, spacing and offset for layout grids.
QgsLayoutMeasurement resolution() const
Returns the page/snap grid resolution.
Style
Style for drawing the page/snapping grid.
QgsLayoutGridSettings(QgsLayout *layout)
Constructor for QgsLayoutGridSettings.
QgsLayoutPoint offset() const
Returns the offset of the page/snap grid.
Style style() const
Returns the style used for drawing the page/snap grids.
void setPen(const QPen &pen)
Sets the pen used for drawing page/snap grids.
void setStyle(const Style style)
Sets the style used for drawing the page/snap grids.
QPen pen() const
Returns the pen used for drawing page/snap grids.
QString stringType() const override
Returns the object type as a string.
Provides a method of storing measurements for use in QGIS layouts using a variety of different measur...
Provides a method of storing points, consisting of an x and y coordinate, for use in QGIS layouts.
An interface for layout objects which can be stored and read from DOM elements.
virtual bool writeXml(QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context) const =0
Stores the objects's state in a DOM element.
virtual bool readXml(const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context)=0
Sets the objects's state from a DOM element.
virtual QgsLayout * layout()=0
Returns the layout the object belongs to.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:50
A container for the context for various read/write operations on objects.