Contains settings and properties relating to how a QgsProject should be displayed inside map canvas, e.g. More...

Inheritance diagram for QgsProjectViewSettings:

Signals
void	mapScalesChanged ()
	Emitted when the list of custom project map scales changes. More...

Public Member Functions
	QgsProjectViewSettings (QObject *parent=nullptr)
	Constructor for QgsProjectViewSettings with the specified parent object. More...

QgsReferencedRectangle	defaultViewExtent () const
	Returns the default view extent, which should be used as the initial map extent when this project is opened. More...

QVector< double >	mapScales () const
	Returns the list of custom project map scales. More...

bool	readXml (const QDomElement &element, const QgsReadWriteContext &context)
	Reads the settings's state from a DOM element. More...

void	reset ()
	Resets the settings to a default state. More...

void	setDefaultViewExtent (const QgsReferencedRectangle &extent)
	Sets the default view extent, which should be used as the initial map extent when this project is opened. More...

void	setMapScales (const QVector< double > &scales)
	Sets the list of custom project map scales. More...

void	setUseProjectScales (bool enabled)
	Sets whether project mapScales() are enabled. More...

bool	useProjectScales () const
	Returns `true` if project mapScales() are enabled. More...

QDomElement	writeXml (QDomDocument &doc, const QgsReadWriteContext &context) const
	Returns a DOM element representing the settings. More...

Detailed Description

Contains settings and properties relating to how a QgsProject should be displayed inside map canvas, e.g.

map scales and default view extent for the project.

Definition at line 34 of file qgsprojectviewsettings.h.

Constructor & Destructor Documentation

QgsProjectViewSettings::QgsProjectViewSettings ( QObject * parent = nullptr )

Constructor for QgsProjectViewSettings with the specified parent object.

Definition at line 20 of file qgsprojectviewsettings.cpp.

QgsReferencedRectangle QgsProjectViewSettings::defaultViewExtent ( ) const

Returns the default view extent, which should be used as the initial map extent when this project is opened.

Warning: When a project is opened in the QGIS desktop application and saved, individual map canvases will store their own previous view extent as custom project properties. Reloading this saved version of the project will trigger the canvases to restore their individual last view extents. Accordingly, in the QGIS desktop application, this setting only forms a default, initial view used when the project is opened for the very first time.

Definition at line 37 of file qgsprojectviewsettings.cpp.

QVector< double > QgsProjectViewSettings::mapScales ( ) const

Returns the list of custom project map scales.

The scales list consists of a list of scale denominator values, e.g. 1000 for a 1:1000 scale.

Definition at line 61 of file qgsprojectviewsettings.cpp.

void QgsProjectViewSettings::mapScalesChanged ( )

signal

Emitted when the list of custom project map scales changes.

bool QgsProjectViewSettings::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	context
	)

Reads the settings's state from a DOM element.

Definition at line 80 of file qgsprojectviewsettings.cpp.

void QgsProjectViewSettings::reset ( )

Resets the settings to a default state.

Definition at line 26 of file qgsprojectviewsettings.cpp.

void QgsProjectViewSettings::setDefaultViewExtent ( const QgsReferencedRectangle & extent )

Sets the default view extent, which should be used as the initial map extent when this project is opened.

Warning: When a project is opened in the QGIS desktop application and saved, individual map canvases will store their own previous view extent as custom project properties. Reloading this saved version of the project will trigger the canvases to restore their individual last view extents. Accordingly, in the QGIS desktop application, this setting only forms a default, initial view used when the project is opened for the very first time.