Reads and writes project states. More...

#include <qgsproject.h>

Collaboration diagram for QgsProject:

Classes
struct	Imp

Signals
void	readProject (const QDomDocument &)
	emitted when project is being read
void	writeProject (QDomDocument &)
	emitted when project is being written
void	readMapLayer (QgsMapLayer *mapLayer, const QDomElement &layerNode)
	Emitted, after the basic initialisation of a layer from the project file is done.
void	writeMapLayer (QgsMapLayer *mapLayer, QDomElement &layerElem, QDomDocument &doc)
	Emitted, when a layer is being saved.
void	projectSaved ()
	emitted when the project file has been written and closed
void	oldProjectVersionWarning (QString)
	emitted when an old project file is read.
void	layerLoaded (int i, int n)
	emitted when a layer from a projects was read
void	loadingLayer (QString)
void	snapSettingsChanged ()

Public Member Functions
	~QgsProject ()
bool	read (QDomNode &layerNode)
	read the layer described in the associated Dom node
void	clearProperties ()
	syntactic sugar for property lists
bool	removeEntry (const QString &scope, const QString &key)
	remove the given key
QStringList	entryList (const QString &scope, const QString &key) const
	return keys with values – do not return keys that contain other keys
QStringList	subkeyList (const QString &scope, const QString &key) const
	return keys with keys – do not return keys that contain only values
void	dumpProperties () const
	dump out current project properties to stderr
QString	writePath (QString filename) const
	prepare a filename to save it to the project file
QString	readPath (QString filename) const
	turn filename read from the project file to an absolute path
QString	error () const
	Return error message from previous read/write.
void	setBadLayerHandler (QgsProjectBadLayerHandler *handler)
	Change handler for missing layers.
QString	layerIsEmbedded (const QString &id) const
	Returns project file path if layer is embedded from other project file.
bool	createEmbeddedLayer (const QString &layerId, const QString &projectFilePath, QList< QDomNode > &brokenNodes, QList< QPair< QgsVectorLayer *, QDomElement > > &vectorLayerList, bool saveFlag=true)
	Creates a maplayer instance defined in an arbitrary project file.
void	setSnapSettingsForLayer (const QString &layerId, bool enabled, QgsSnapper::SnappingType type, QgsTolerance::UnitType unit, double tolerance, bool avoidIntersection)
	Convenience function to set snap settings per layer.
bool	snapSettingsForLayer (const QString &layerId, bool &enabled, QgsSnapper::SnappingType &type, QgsTolerance::UnitType &units, double &tolerance, bool &avoidIntersection) const
	Convenience function to query snap settings of a layer.
void	setTopologicalEditing (bool enabled)
	Convenience function to set topological editing.
bool	topologicalEditing () const
	Convenience function to query topological editing status.
QString	homePath () const
	Return project's home path.
QgsRelationManager *	relationManager () const

void	title (const QString &title)
	Every project has an associated title string.
const QString &	title () const
	returns title

bool	isDirty () const
	the dirty flag is true if the project has been modified since the last write()
void	dirty (bool b)

void	setFileName (const QString &name)
	Every project has an associated file that contains its XML.
QString	fileName () const
	returns file name

bool	read (const QFileInfo &file)
	read project file
bool	read ()
	presuming that the caller has already reset the map canvas, map registry, and legend

bool	write (const QFileInfo &file)
	write project file
bool	write ()

bool	writeEntry (const QString &scope, const QString &key, bool value)
bool	writeEntry (const QString &scope, const QString &key, double value)
bool	writeEntry (const QString &scope, const QString &key, int value)
bool	writeEntry (const QString &scope, const QString &key, const QString &value)
bool	writeEntry (const QString &scope, const QString &key, const QStringList &value)

QStringList	readListEntry (const QString &scope, const QString &key, QStringList def=QStringList(), bool *ok=0) const
	key value accessors
QString	readEntry (const QString &scope, const QString &key, const QString &def=QString::null, bool *ok=0) const
int	readNumEntry (const QString &scope, const QString &key, int def=0, bool *ok=0) const
double	readDoubleEntry (const QString &scope, const QString &key, double def=0, bool *ok=0) const
bool	readBoolEntry (const QString &scope, const QString &key, bool def=false, bool *ok=0) const

Static Public Member Functions
static QgsProject *	instance ()
	access to canonical QgsProject instance

Protected Member Functions
void	setError (QString errorMessage)
	Set error message from read/write operation.
void	clearError ()
	Clear error message.
bool	addLayer (const QDomElement &layerElem, QList< QDomNode > &brokenNodes, QList< QPair< QgsVectorLayer *, QDomElement > > &vectorLayerList)

Private Member Functions
	QgsProject ()
	QgsProject (QgsProject const &)
QPair< bool, QList< QDomNode > >	_getMapLayers (QDomDocument const &doc)
	Read map layers from project file.
void	snapSettings (QStringList &layerIdList, QStringList &enabledList, QStringList &snapTypeList, QStringList &snapUnitList, QStringList &toleranceUnitList, QStringList &avoidIntersectionList) const

Private Attributes
std::auto_ptr< Imp >	imp_
	implementation handle
QString	mErrorMessage
QgsProjectBadLayerHandler *	mBadLayerHandler
QHash< QString, QPair< QString, bool > >	mEmbeddedLayers
	Embeded layers which are defined in other projects.
QgsRelationManager *	mRelationManager

Static Private Attributes
static QgsProject *	theProject_ = 0

Detailed Description

Reads and writes project states.

Note

Has two general kinds of state to make persistent. (I.e., to read and write.) First, Qgis proprietary information. Second plug-in information.

A singleton since there shall only be one active project at a time; and provides canonical location for plug-ins and main app to find/set properties.

Might want to consider moving from Singleton; i.e., allowing more than one project. Just as the GIMP can have simultaneous multiple images, perhaps qgis can one day have simultaneous multiple projects.

Definition at line 65 of file qgsproject.h.

Constructor & Destructor Documentation

QgsProject::~QgsProject ( )

Todo:: XXX Should have semantics for saving project if dirty as last gasp?

Definition at line 352 of file qgsproject.cpp.

References mBadLayerHandler, and mRelationManager.

QgsProject::QgsProject ( )

private

Definition at line 335 of file qgsproject.cpp.

References dirty(), and writeEntry().

Referenced by instance().

QgsProject::QgsProject ( QgsProject const & )

private

Member Function Documentation

QPair< bool, QList< QDomNode > > QgsProject::_getMapLayers ( QDomDocument const & doc )

private

Read map layers from project file.

Returns: QPair< bool, QList<QDomNode> >

bool is true if function worked; else is false. list contains nodes corresponding to layers that couldn't be loaded

Note: XML of form:

   <maplayer type="vector">
      <layername>Hydrop</layername>
      <datasource>/data/usgs/city_shp/hydrop.shp</datasource>
      <zorder>0</zorder>
      <provider>ogr</provider>
      <singlesymbol>
         <renderitem>
            <value>blabla</value>
            <symbol>
               <outlinecolor red="85" green="0" blue="255" />
               <outlinestyle>SolidLine</outlinestyle>
               <outlinewidth>1</outlinewidth>
               <fillcolor red="0" green="170" blue="255" />
               <fillpattern>SolidPattern</fillpattern>
            </symbol>
            <label>blabla</label>
         </renderitem>
      </singlesymbol>
      <label>0</label>
      <labelattributes>
         <label text="Label" field="" />
         <family name="Sans Serif" field="" />
         <size value="12" units="pt" field="" />
         <bold on="0" field="" />
         <italic on="0" field="" />
         <underline on="0" field="" />
         <color red="0" green="0" blue="0" field="" />
         <x field="" />
         <y field="" />
         <offset  units="pt" x="0" xfield="" y="0" yfield="" />
         <angle value="0" field="" />
         <alignment value="center" field="" />
      </labelattributes>
   </maplayer>

Definition at line 647 of file qgsproject.cpp.

References addLayer(), createEmbeddedLayer(), layerLoaded(), loadingLayer(), readPath(), and tr.

Referenced by read().

bool QgsProject::addLayer	(	const QDomElement &	layerElem,
		QList< QDomNode > &	brokenNodes,
		QList< QPair< QgsVectorLayer *, QDomElement > > &	vectorLayerList
	)

protected

Note: not available in python bindings

Definition at line 720 of file qgsproject.cpp.

References instance(), QgsMapLayer::isValid(), QgsDebugMsg, QgsMapLayer::readLayerXML(), readMapLayer(), and QgsVectorLayer::vectorJoins().

Referenced by _getMapLayers(), createEmbeddedLayer(), and read().

void QgsProject::clearError ( )

protected

Clear error message.

Note: added in 1.4

Definition at line 1562 of file qgsproject.cpp.

References setError().

Referenced by read(), and write().

void QgsProject::clearProperties ( )

syntactic sugar for property lists

extra properties, typically added by plug-ins

This allows for extra properties to be associated with projects. Think of it as a registry bound to a project.

Properties are arbitrary values keyed by a name and associated with a scope. The scope would presumably refer to your plug-in. E.g., "openmodeller".

Note

E.g., open modeller might use:

"QgsProject::instance()->properties("openmodeller")["foo"].

Todo:: "properties" is, overall, a good name; but that might imply that the qgis specific state properites are different since they aren't accessible here. Actually, what if we make "qgis" yet another scope that stores its state in the properties list? E.g., QgsProject::instance()->properties()["qgis"]?

removes all project properties

Definition at line 1094 of file qgsproject.cpp.

References dirty(), and imp_.

bool QgsProject::createEmbeddedLayer	(	const QString &	layerId,
		const QString &	projectFilePath,
		QList< QDomNode > &	brokenNodes,
		QList< QPair< QgsVectorLayer *, QDomElement > > &	vectorLayerList,
		bool	saveFlag = `true`
	)

Creates a maplayer instance defined in an arbitrary project file.

Caller takes ownership

Returns: the layer or 0 in case of error

Note: : added in version 1.8; not available in python bindings

Definition at line 1583 of file qgsproject.cpp.

References addLayer(), mEmbeddedLayers, and QgsDataSourceURI::setDatabase().

Referenced by _getMapLayers().

void QgsProject::dirty ( bool b )

Definition at line 391 of file qgsproject.cpp.

References imp_.

Referenced by QgsRelationManager::addRelation(), clearProperties(), QgsComposition::endCommand(), QgsComposition::endMultiFrameCommand(), QgsComposition::pushAddRemoveCommand(), QgsProject(), read(), removeEntry(), QgsComposerMultiFrameCommand::restoreState(), QgsComposerItemCommand::restoreState(), setFileName(), QgsAddRemoveMultiFrameCommand::switchState(), QgsAddRemoveItemCommand::switchState(), title(), write(), and writeEntry().

void QgsProject::dumpProperties ( ) const

dump out current project properties to stderr

Todo:: XXX Now slightly broken since re-factoring. Won't print out top-level key and redundantly prints sub-keys.

Definition at line 1354 of file qgsproject.cpp.

References dump_(), and imp_.

QStringList QgsProject::entryList	(	const QString &	scope,
		const QString &	key
	)		const

return keys with values – do not return keys that contain other keys

Note: equivalent to QSettings entryList()

Definition at line 1316 of file qgsproject.cpp.

References QgsPropertyKey::entryList(), findKey_(), and imp_.

QString QgsProject::error ( ) const

Return error message from previous read/write.

Note: added in 1.4

Definition at line 1557 of file qgsproject.cpp.

References mErrorMessage.

QString QgsProject::fileName ( ) const

returns file name

Definition at line 407 of file qgsproject.cpp.

References imp_.

Referenced by homePath(), readPath(), write(), and writePath().

QString QgsProject::homePath ( ) const

Return project's home path.

Returns: home path of project (or QString::null if not set)

Note: added in version 2.0

Definition at line 1818 of file qgsproject.cpp.

References fileName().

Referenced by readPath(), and QgsBrowserModel::updateProjectHome().

QgsProject * QgsProject::instance ( )

static

access to canonical QgsProject instance

Definition at line 362 of file qgsproject.cpp.

References QgsProject(), and theProject_.

Referenced by addLayer(), QgsGeometry::avoidIntersections(), QgsProject::Imp::clear(), QgsPalLabeling::clearEngineSettings(), QgsOfflineEditing::convertToOfflineProject(), QgsSymbolV2::defaultSymbol(), QgsComposition::endCommand(), QgsComposition::endMultiFrameCommand(), QgsMapToolIdentify::featureDerivedAttributes(), QgsProjectBadLayerGuiHandler::findMissingFile(), QgsMapToolIdentify::identify(), QgsAttributeDialog::init(), QgsComposerMap::initGridAnnotationFormatFromProject(), QgsOfflineEditing::isOfflineProject(), QgsPalLabeling::loadEngineSettings(), QgsMapLayer::loadNamedStyle(), QgsComposerScaleBar::mapWidth(), QgsOWSSourceSelect::on_mChangeCRSButton_clicked(), QgsVectorLayer::onRelationsLoaded(), QgsOfflineEditing::openLoggingDb(), QgsComposition::pushAddRemoveCommand(), QgsBrowserModel::QgsBrowserModel(), QgsComposerMap::QgsComposerMap(), QgsMapCanvas::QgsMapCanvas(), QgsOWSSourceSelect::QgsOWSSourceSelect(), QgsVectorLayer::QgsVectorLayer(), QgsMapLayer::readLayerXML(), QgsVectorLayer::readSymbology(), QgsSvgAnnotationItem::readXML(), QgsComposerPicture::readXML(), QgsVectorLayer::referencingRelations(), QgsMapRenderer::render(), QgsComposerMultiFrameCommand::restoreState(), QgsComposerItemCommand::restoreState(), QgsPalLabeling::saveEngineSettings(), setTopologicalEditing(), QgsMapCanvasSnapper::snapToBackgroundLayers(), QgsMapCanvasSnapper::snapToCurrentLayer(), QgsAddRemoveMultiFrameCommand::switchState(), QgsAddRemoveItemCommand::switchState(), QgsSymbolLayerV2Utils::symbolNameToPath(), QgsSymbolLayerV2Utils::symbolPathToName(), QgsOfflineEditing::synchronize(), topologicalEditing(), QgsBrowserModel::updateProjectHome(), write(), QgsMapLayer::writeLayerXML(), QgsVectorLayer::writeSymbology(), QgsSvgAnnotationItem::writeXML(), and QgsComposerPicture::writeXML().

bool QgsProject::isDirty ( ) const

the dirty flag is true if the project has been modified since the last write()

Definition at line 385 of file qgsproject.cpp.

References imp_.

QString QgsProject::layerIsEmbedded ( const QString & id ) const

Returns project file path if layer is embedded from other project file.

Returns empty string if layer is not embedded

Definition at line 1573 of file qgsproject.cpp.

References mEmbeddedLayers.

Referenced by write().

void QgsProject::layerLoaded	(	int	i,
		int	n
	)

signal

emitted when a layer from a projects was read

Referenced by _getMapLayers().

void QgsProject::loadingLayer ( QString )

signal

Referenced by _getMapLayers().

void QgsProject::oldProjectVersionWarning ( QString )

signal

emitted when an old project file is read.

Referenced by read().

void QgsProject::projectSaved ( )

signal

emitted when the project file has been written and closed

Referenced by write().

bool QgsProject::read ( const QFileInfo & file )

read project file

Please note that most of the contents were copied from qgsproject.

Note: Any current plug-in state is erased; dirty set to false after successful invocation; file name argument implicitly sets file

(Is that really desirable behavior? Maybe prompt to save before reading new one?)

Should we presume the file is opened elsewhere? Or do we open it ourselves?

XXX How to best get modify access to Qgis state? Actually we can finagle that by searching for qgisapp in object hiearchy.

Note

Gets the extents
Creates maplayers
Registers maplayers

Note: it's presumed that the caller has already reset the map canvas, map registry, and legend

Definition at line 778 of file qgsproject.cpp.

References imp_, and read().

Referenced by QgsProjectBadLayerGuiHandler::findMissingFile().

bool QgsProject::read ( )

presuming that the caller has already reset the map canvas, map registry, and legend

Shows a warning when an old project file is read.

Definition at line 790 of file qgsproject.cpp.

References _getMapLayers(), _getProperties(), _getTitle(), _getVersion(), QgsRelationManager::clear(), clearError(), dirty(), dump_(), QgsProjectBadLayerHandler::handleBadLayers(), imp_, mBadLayerHandler, mEmbeddedLayers, mRelationManager, oldProjectVersionWarning(), QGis::QGIS_VERSION, QgsDebugMsg, readProject(), setError(), QgsProjectVersion::text(), tr, and QgsLogger::warning().

Referenced by read().

bool QgsProject::read ( QDomNode & layerNode )

read the layer described in the associated Dom node

Parameters

layerNode represents a QgsProject Dom node that maps to a specific layer.

QgsProject raises an exception when one of the QgsProject::read() implementations fails. Since the read()s are invoked from qgisapp, then qgisapp handles the exception. It prompts the user for the new location of the data, if any. If there is a new location, the Dom node associated with the layer has its datasource tag corrected. Then that node is passed to this member function to be re-opened.

Definition at line 918 of file qgsproject.cpp.

References addLayer().

bool QgsProject::readBoolEntry	(	const QString &	scope,
		const QString &	key,
		bool	def = `false`,
		bool *	ok = `0`
	)		const

Definition at line 1277 of file qgsproject.cpp.

References findKey_(), and imp_.

Referenced by QgsPalLabeling::loadEngineSettings(), readPath(), and writePath().

double QgsProject::readDoubleEntry	(	const QString &	scope,
		const QString &	key,
		double	def = `0`,
		bool *	ok = `0`
	)		const

Definition at line 1247 of file qgsproject.cpp.

References findKey_(), and imp_.

QString QgsProject::readEntry	(	const QString &	scope,
		const QString &	key,
		const QString &	def = `QString::null`,
		bool *	ok = `0`
	)		const

Definition at line 1187 of file qgsproject.cpp.

References findKey_(), and imp_.

Referenced by QgsSymbolV2::defaultSymbol(), QgsMapToolIdentify::featureDerivedAttributes(), QgsComposerMap::initGridAnnotationFormatFromProject(), QgsOfflineEditing::isOfflineProject(), QgsOWSSourceSelect::on_mChangeCRSButton_clicked(), and QgsOfflineEditing::openLoggingDb().

QStringList QgsProject::readListEntry	(	const QString &	scope,
		const QString &	key,
		QStringList	def = `QStringList()`,
		bool *	ok = `0`
	)		const

key value accessors

keys would be the familiar QSettings-like '/' delimited entries, implying a hierarchy of keys and corresponding values

Note: The key string must include '/'s. E.g., "/foo" not "foo".

Definition at line 1156 of file qgsproject.cpp.

References findKey_(), and imp_.

Referenced by QgsGeometry::avoidIntersections(), QgsMapToolIdentify::identify(), snapSettings(), and QgsMapCanvasSnapper::snapToBackgroundLayers().

void QgsProject::readMapLayer	(	QgsMapLayer *	mapLayer,
		const QDomElement &	layerNode
	)

signal

Emitted, after the basic initialisation of a layer from the project file is done.

You can use this signal to read additional information from the project file.

Parameters

mapLayer	The map layer which is being initialized
layerNode	The layer node from the project file

Referenced by addLayer().

int QgsProject::readNumEntry	(	const QString &	scope,
		const QString &	key,
		int	def = `0`,
		bool *	ok = `0`
	)		const

Definition at line 1218 of file qgsproject.cpp.

References findKey_(), and imp_.

Referenced by QgsPalLabeling::loadEngineSettings(), QgsComposerMap::QgsComposerMap(), QgsOWSSourceSelect::QgsOWSSourceSelect(), QgsMapRenderer::render(), QgsMapCanvasSnapper::snapToBackgroundLayers(), QgsMapCanvasSnapper::snapToCurrentLayer(), and topologicalEditing().

QString QgsProject::readPath ( QString filename ) const

turn filename read from the project file to an absolute path

Note: added in 1.3

Definition at line 1361 of file qgsproject.cpp.

References fileName(), homePath(), qgsVsiPrefix(), and readBoolEntry().

Referenced by _getMapLayers(), QgsMapLayer::readLayerXML(), QgsVectorLayer::readSymbology(), QgsSvgAnnotationItem::readXML(), and QgsComposerPicture::readXML().

void QgsProject::readProject ( const QDomDocument & )

signal

emitted when project is being read

Referenced by read().

QgsRelationManager * QgsProject::relationManager ( ) const

Definition at line 1827 of file qgsproject.cpp.

References mRelationManager.

Referenced by QgsAttributeDialog::init(), and QgsVectorLayer::referencingRelations().

bool QgsProject::removeEntry	(	const QString &	scope,
		const QString &	key
	)

remove the given key

Definition at line 1305 of file qgsproject.cpp.

References dirty(), findKey_(), imp_, and removeKey_().

Referenced by QgsPalLabeling::clearEngineSettings(), and QgsOfflineEditing::synchronize().

void QgsProject::setBadLayerHandler ( QgsProjectBadLayerHandler * handler )

Change handler for missing layers.

Deletes old handler and takes ownership of the new one.

Note: added in 1.4

Definition at line 1567 of file qgsproject.cpp.

References mBadLayerHandler.

void QgsProject::setError ( QString errorMessage )

protected

Set error message from read/write operation.

Note: added in 1.4

Definition at line 1552 of file qgsproject.cpp.

References mErrorMessage.

Referenced by clearError(), read(), and write().

void QgsProject::setFileName ( const QString & name )

Every project has an associated file that contains its XML.

Definition at line 398 of file qgsproject.cpp.

References dirty(), and imp_.

void QgsProject::setSnapSettingsForLayer	(	const QString &	layerId,
		bool	enabled,
		QgsSnapper::SnappingType	type,
		QgsTolerance::UnitType	unit,
		double	tolerance,
		bool	avoidIntersection
	)

Convenience function to set snap settings per layer.

Note: added in version 1.9

Definition at line 1678 of file qgsproject.cpp.

References QgsTolerance::Pixels, snapSettings(), snapSettingsChanged(), QgsSnapper::SnapToSegment, QgsSnapper::SnapToVertexAndSegment, and writeEntry().

void QgsProject::setTopologicalEditing ( bool enabled )

Convenience function to set topological editing.

Note: added in version 1.9

Definition at line 1802 of file qgsproject.cpp.

References instance(), snapSettingsChanged(), and writeEntry().

void QgsProject::snapSettings	(	QStringList &	layerIdList,
		QStringList &	enabledList,
		QStringList &	snapTypeList,
		QStringList &	snapUnitList,
		QStringList &	toleranceUnitList,
		QStringList &	avoidIntersectionList
	)		const

private

Definition at line 1791 of file qgsproject.cpp.

References readListEntry().

Referenced by setSnapSettingsForLayer(), and snapSettingsForLayer().

void QgsProject::snapSettingsChanged ( )

signal

Referenced by setSnapSettingsForLayer(), and setTopologicalEditing().

bool QgsProject::snapSettingsForLayer	(	const QString &	layerId,
		bool &	enabled,
		QgsSnapper::SnappingType &	type,
		QgsTolerance::UnitType &	units,
		double &	tolerance,
		bool &	avoidIntersection
	)		const

Convenience function to query snap settings of a layer.

Note: added in version 1.9

Definition at line 1735 of file qgsproject.cpp.

References QgsTolerance::MapUnits, QgsTolerance::Pixels, snapSettings(), QgsSnapper::SnapToSegment, QgsSnapper::SnapToVertex, and QgsSnapper::SnapToVertexAndSegment.

QStringList QgsProject::subkeyList	(	const QString &	scope,
		const QString &	key
	)		const

return keys with keys – do not return keys that contain only values

Note: equivalent to QSettings subkeyList()

Definition at line 1334 of file qgsproject.cpp.

References findKey_(), imp_, and QgsPropertyKey::subkeyList().

void QgsProject::title ( const QString & title )

Every project has an associated title string.

Todo:: However current dialogs don't allow setting of it yet

Definition at line 371 of file qgsproject.cpp.

References dirty(), imp_, and title().

Referenced by QgsOfflineEditing::convertToOfflineProject(), and QgsOfflineEditing::synchronize().

QString const & QgsProject::title ( ) const

returns title

Definition at line 379 of file qgsproject.cpp.

References imp_.

Referenced by title(), and write().

bool QgsProject::topologicalEditing ( ) const

Convenience function to query topological editing status.

Note: added in version 1.9

Definition at line 1808 of file qgsproject.cpp.

References instance(), and readNumEntry().

bool QgsProject::write ( const QFileInfo & file )

write project file

XXX How to best get read access to Qgis state? Actually we can finagle that by searching for qgisapp in object hiearchy.

Note: file name argument implicitly sets file; dirty set to false after successful invocation

Definition at line 927 of file qgsproject.cpp.

References imp_, and write().

bool QgsProject::write ( )

Definition at line 935 of file qgsproject.cpp.

References clearError(), dirty(), dump_(), fileName(), QgsMapLayer::id(), imp_, instance(), layerIsEmbedded(), mEmbeddedLayers, projectSaved(), QGis::QGIS_VERSION, QgsDebugMsg, setError(), title(), tr, QgsMapLayer::writeLayerXML(), writeMapLayer(), writePath(), and writeProject().

Referenced by write().

bool QgsProject::writeEntry	(	const QString &	scope,
		const QString &	key,
		bool	value
	)

Note: available in python bindings as writeEntryBool

Definition at line 1106 of file qgsproject.cpp.

References addKey_(), dirty(), and imp_.

Referenced by QgsProject::Imp::clear(), QgsOfflineEditing::convertToOfflineProject(), QgsProject(), QgsPalLabeling::saveEngineSettings(), setSnapSettingsForLayer(), and setTopologicalEditing().

bool QgsProject::writeEntry	(	const QString &	scope,
		const QString &	key,
		double	value
	)

Note: available in python bindings as writeEntryDouble

Definition at line 1115 of file qgsproject.cpp.

References addKey_(), dirty(), and imp_.

bool QgsProject::writeEntry	(	const QString &	scope,
		const QString &	key,
		int	value
	)

Definition at line 1125 of file qgsproject.cpp.

References addKey_(), dirty(), and imp_.

bool QgsProject::writeEntry	(	const QString &	scope,
		const QString &	key,
		const QString &	value
	)

Definition at line 1134 of file qgsproject.cpp.

References addKey_(), dirty(), and imp_.

bool QgsProject::writeEntry	(	const QString &	scope,
		const QString &	key,
		const QStringList &	value
	)

Definition at line 1144 of file qgsproject.cpp.

References addKey_(), dirty(), and imp_.

void QgsProject::writeMapLayer	(	QgsMapLayer *	mapLayer,
		QDomElement &	layerElem,
		QDomDocument &	doc
	)

signal

Emitted, when a layer is being saved.

You can use this method to save additional information to the layer.

Parameters

mapLayer	The map layer which is being initialized
layerElem	The layer element from the project file
doc	The document

Referenced by write().

QString QgsProject::writePath ( QString filename ) const

prepare a filename to save it to the project file

Note: added in 1.3

Definition at line 1465 of file qgsproject.cpp.

References fileName(), qgsVsiPrefix(), and readBoolEntry().

Referenced by QgsSymbolLayerV2Utils::symbolPathToName(), write(), and QgsMapLayer::writeLayerXML().

void QgsProject::writeProject ( QDomDocument & )

signal

emitted when project is being written

Referenced by write().

Member Data Documentation

std::auto_ptr<Imp> QgsProject::imp_

private

implementation handle

Definition at line 383 of file qgsproject.h.

Referenced by clearProperties(), dirty(), dumpProperties(), entryList(), fileName(), isDirty(), read(), readBoolEntry(), readDoubleEntry(), readEntry(), readListEntry(), readNumEntry(), removeEntry(), setFileName(), subkeyList(), title(), write(), and writeEntry().

QgsProjectBadLayerHandler* QgsProject::mBadLayerHandler

private

Definition at line 394 of file qgsproject.h.

Referenced by read(), setBadLayerHandler(), and ~QgsProject().

QHash< QString, QPair< QString, bool> > QgsProject::mEmbeddedLayers

private

Embeded layers which are defined in other projects.

Key: layer id, value: pair< project file path, save layer yes / no (e.g. if the layer is part of an embedded group, loading/saving is done by the legend) If the project file path is empty, QgsProject is going to ignore the layer for saving (e.g. because it is part and managed by an embedded group)

Definition at line 399 of file qgsproject.h.

Referenced by createEmbeddedLayer(), layerIsEmbedded(), read(), and write().

QString QgsProject::mErrorMessage

private

Definition at line 392 of file qgsproject.h.

Referenced by error(), and setError().

QgsRelationManager* QgsProject::mRelationManager

private

Definition at line 404 of file qgsproject.h.

Referenced by read(), relationManager(), and ~QgsProject().

QgsProject * QgsProject::theProject_ = 0

staticprivate

Definition at line 388 of file qgsproject.h.

Referenced by instance().

The documentation for this class was generated from the following files:

/tmp/buildd/qgis-2.2.0+wheezy1/src/core/qgsproject.h
/tmp/buildd/qgis-2.2.0+wheezy1/src/core/qgsproject.cpp

Classes

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation