QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgslayoutgridsettings.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutgridsettings.cpp
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
18
19#include "qgslayout.h"
21#include "qgslayoutundostack.h"
22#include "qgsreadwritecontext.h"
23#include "qgssettings.h"
24#include "qgsunittypes.h"
25
26#include <QString>
27
28using namespace Qt::StringLiterals;
29
31 : mGridResolution( QgsLayoutMeasurement( 10 ) )
32 , mLayout( layout )
33{
34 mGridPen = QPen( QColor( 190, 190, 190, 100 ), 0 );
35 mGridPen.setCosmetic( true );
37}
38
40{
41 return mLayout;
42}
43
45{
46 mLayout->undoStack()->beginCommand( this, QObject::tr( "Change Grid Resolution" ), UndoGridResolution );
47 mGridResolution = resolution;
48 mLayout->undoStack()->endCommand();
49}
50
52{
53 mLayout->undoStack()->beginCommand( this, QObject::tr( "Change Grid Offset" ), UndoGridOffset );
54 mGridOffset = offset;
55 mLayout->undoStack()->endCommand();
56}
57
59{
60 //read grid style, grid color and pen width from settings
61 const QgsSettings s;
62
63 QString gridStyleString;
64 gridStyleString = s.value( u"LayoutDesigner/gridStyle"_s, "Dots", QgsSettings::Gui ).toString();
65
66 int gridRed, gridGreen, gridBlue, gridAlpha;
67 gridRed = s.value( u"LayoutDesigner/gridRed"_s, 190, QgsSettings::Gui ).toInt();
68 gridGreen = s.value( u"LayoutDesigner/gridGreen"_s, 190, QgsSettings::Gui ).toInt();
69 gridBlue = s.value( u"LayoutDesigner/gridBlue"_s, 190, QgsSettings::Gui ).toInt();
70 gridAlpha = s.value( u"LayoutDesigner/gridAlpha"_s, 100, QgsSettings::Gui ).toInt();
71 const QColor gridColor = QColor( gridRed, gridGreen, gridBlue, gridAlpha );
72
73 mGridPen.setColor( gridColor );
74 mGridPen.setWidthF( 0 );
75 mGridPen.setCosmetic( true );
76
77 if ( gridStyleString == "Dots"_L1 )
78 {
79 mGridStyle = StyleDots;
80 }
81 else if ( gridStyleString == "Crosses"_L1 )
82 {
83 mGridStyle = StyleCrosses;
84 }
85 else
86 {
87 mGridStyle = StyleLines;
88 }
89
90 mGridResolution = QgsLayoutMeasurement( s.value( u"LayoutDesigner/defaultSnapGridResolution"_s, 10.0, QgsSettings::Gui ).toDouble(), Qgis::LayoutUnit::Millimeters );
91// mSnapToleranceSpinBox->setValue( mSettings->value( u"LayoutDesigner/defaultSnapTolerancePixels"_s, 5, QgsSettings::Gui ).toInt() );
92 mGridOffset = QgsLayoutPoint( s.value( u"LayoutDesigner/defaultSnapGridOffsetX"_s, 0, QgsSettings::Gui ).toDouble(),
93 s.value( u"LayoutDesigner/defaultSnapGridOffsetY"_s, 0, QgsSettings::Gui ).toDouble(), Qgis::LayoutUnit::Millimeters );
94}
95
96bool QgsLayoutGridSettings::writeXml( QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext & ) const
97{
98 QDomElement element = document.createElement( u"Grid"_s );
99
100 element.setAttribute( u"resolution"_s, mGridResolution.length() );
101 element.setAttribute( u"resUnits"_s, QgsUnitTypes::encodeUnit( mGridResolution.units() ) );
102
103 element.setAttribute( u"offsetX"_s, mGridOffset.x() );
104 element.setAttribute( u"offsetY"_s, mGridOffset.y() );
105 element.setAttribute( u"offsetUnits"_s, QgsUnitTypes::encodeUnit( mGridOffset.units() ) );
106
107 parentElement.appendChild( element );
108 return true;
109}
110
111bool QgsLayoutGridSettings::readXml( const QDomElement &e, const QDomDocument &, const QgsReadWriteContext & )
112{
113 QDomElement element = e;
114 if ( element.nodeName() != "Grid"_L1 )
115 {
116 element = element.firstChildElement( u"Grid"_s );
117 }
118
119 if ( element.nodeName() != "Grid"_L1 )
120 {
121 return false;
122 }
123
124 const double res = element.attribute( u"resolution"_s, u"10"_s ).toDouble();
125 const Qgis::LayoutUnit resUnit = QgsUnitTypes::decodeLayoutUnit( element.attribute( u"resUnits"_s ) );
126 mGridResolution = QgsLayoutMeasurement( res, resUnit );
127
128 const double offsetX = element.attribute( u"offsetX"_s ).toDouble();
129 const double offsetY = element.attribute( u"offsetY"_s ).toDouble();
130 const Qgis::LayoutUnit offsetUnit = QgsUnitTypes::decodeLayoutUnit( element.attribute( u"offsetUnits"_s ) );
131 mGridOffset = QgsLayoutPoint( offsetX, offsetY, offsetUnit );
132
133 mLayout->pageCollection()->redraw();
134
135 return true;
136}
137
LayoutUnit
Layout measurement units.
Definition qgis.h:5275
@ Millimeters
Millimeters.
Definition qgis.h:5276
QgsLayoutMeasurement resolution() const
Returns the page/snap grid resolution.
QgsLayout * layout() override
Returns the layout the object belongs to.
QgsLayoutGridSettings(QgsLayout *layout)
Constructor for QgsLayoutGridSettings.
QgsLayoutPoint offset() const
Returns the offset of the page/snap grid.
void setOffset(const QgsLayoutPoint &offset)
Sets the offset of the page/snap grid.
bool writeXml(QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context) const override
Stores the grid's state in a DOM element.
bool readXml(const QDomElement &gridElement, const QDomDocument &document, const QgsReadWriteContext &context) override
Sets the grid's state from a DOM element.
void loadFromSettings()
Loads grid settings from the application layout settings.
void setResolution(QgsLayoutMeasurement resolution)
Sets the page/snap grid resolution.
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.
void beginCommand(QgsLayoutUndoObjectInterface *object, const QString &commandText, int id=0)
Begins a new undo command for the specified object.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:50
QgsLayoutUndoStack * undoStack()
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's ...
A container for the context for various read/write operations on objects.
Stores settings for use within QGIS.
Definition qgssettings.h:68
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), Section section=NoSection) const
Returns the value for setting key.
static Q_INVOKABLE Qgis::LayoutUnit decodeLayoutUnit(const QString &string, bool *ok=nullptr)
Decodes a layout unit from a string.
static Q_INVOKABLE QString encodeUnit(Qgis::DistanceUnit unit)
Encodes a distance unit to a string.