Manages storage of a set of QgsAnnotation annotation objects. More...

#include <qgsannotationmanager.h>

Inheritance diagram for QgsAnnotationManager:

Signals
void	annotationAboutToBeRemoved (QgsAnnotation *annotation)
	Emitted when an annotation is about to be removed from the manager. More...

void	annotationAdded (QgsAnnotation *annotation)
	Emitted when a annotation has been added to the manager. More...

void	annotationRemoved ()
	Emitted when an annotation was removed from the manager. More...

Public Member Functions
	QgsAnnotationManager (QgsProject *project=nullptr)
	Constructor for QgsAnnotationManager. More...

	~QgsAnnotationManager () override

bool	addAnnotation (QgsAnnotation *annotation)
	Adds an annotation to the manager. More...

QList< QgsAnnotation *>	annotations () const
	Returns a list of all annotations contained in the manager. More...

void	clear ()
	Removes and deletes all annotations from the manager. More...

QList< QgsAnnotation *>	cloneAnnotations () const
	Returns a list containing clones of all annotations contained in the manager. More...

bool	readXml (const QDomElement &element, const QgsReadWriteContext &context)
	Reads the manager's state from a DOM element, restoring all annotations present in the XML document. More...

bool	removeAnnotation (QgsAnnotation *annotation)
	Removes an annotation from the manager. More...

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

Detailed Description

Manages storage of a set of QgsAnnotation annotation objects.

Since: QGIS 3.0

QgsAnnotationManager handles the storage, serializing and deserializing of QgsAnnotations. Usually this class is not constructed directly, but rather accessed through a QgsProject via QgsProject::annotationManager().

QgsAnnotationManager retains ownership of all the annotations contained in the manager.

Definition at line 43 of file qgsannotationmanager.h.

Constructor & Destructor Documentation

◆ QgsAnnotationManager()

QgsAnnotationManager::QgsAnnotationManager ( QgsProject * project = nullptr )

explicit

Constructor for QgsAnnotationManager.

The project will become the parent object for this manager.

Definition at line 21 of file qgsannotationmanager.cpp.

◆ ~QgsAnnotationManager()

QgsAnnotationManager::~QgsAnnotationManager ( )

override

Definition at line 28 of file qgsannotationmanager.cpp.

Member Function Documentation

◆ addAnnotation()

bool QgsAnnotationManager::addAnnotation ( QgsAnnotation * annotation )

Adds an annotation to the manager.

Ownership of the annotation is transferred to the manager. Returns true if the addition was successful, or false if the annotation could not be added.

See also: removeAnnotation(); annotationAdded()

Definition at line 33 of file qgsannotationmanager.cpp.

◆ annotationAboutToBeRemoved

void QgsAnnotationManager::annotationAboutToBeRemoved ( QgsAnnotation * annotation )

signal

Emitted when an annotation is about to be removed from the manager.

◆ annotationAdded

void QgsAnnotationManager::annotationAdded ( QgsAnnotation * annotation )

signal

Emitted when a annotation has been added to the manager.

◆ annotationRemoved

void QgsAnnotationManager::annotationRemoved ( )

signal

Emitted when an annotation was removed from the manager.

◆ annotations()

QList< QgsAnnotation * > QgsAnnotationManager::annotations ( ) const

Returns a list of all annotations contained in the manager.

See also: cloneAnnotations()

Definition at line 71 of file qgsannotationmanager.cpp.

◆ clear()

void QgsAnnotationManager::clear ( )

Removes and deletes all annotations from the manager.

See also: removeAnnotation()

Definition at line 63 of file qgsannotationmanager.cpp.

◆ cloneAnnotations()

QList< QgsAnnotation * > QgsAnnotationManager::cloneAnnotations ( ) const

Returns a list containing clones of all annotations contained in the manager.

The caller takes responsibility for deleting all returned annotations.

See also: annotations()

Definition at line 76 of file qgsannotationmanager.cpp.

◆ readXml()

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

Reads the manager's state from a DOM element, restoring all annotations present in the XML document.

See also: writeXml()

Definition at line 86 of file qgsannotationmanager.cpp.

◆ removeAnnotation()

bool QgsAnnotationManager::removeAnnotation ( QgsAnnotation * annotation )

Removes an annotation from the manager.

The annotation is deleted. Returns true if the removal was successful, or false if the removal failed (eg as a result of removing an annotation which is not contained in the manager).

See also: addAnnotation(); compositionRemoved(); compositionAboutToBeRemoved(); clear()

Definition at line 47 of file qgsannotationmanager.cpp.

◆ writeXml()

QDomElement QgsAnnotationManager::writeXml	(	QDomDocument &	doc,
		const QgsReadWriteContext &	context
	)		const

Returns a DOM element representing the state of the manager.

See also: readXml()

Definition at line 125 of file qgsannotationmanager.cpp.

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

/tmp/buildd/qgis-3.0.2+14stretch/src/core/annotations/qgsannotationmanager.h
/tmp/buildd/qgis-3.0.2+14stretch/src/core/annotations/qgsannotationmanager.cpp

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsAnnotationManager()

◆ ~QgsAnnotationManager()

Member Function Documentation

◆ addAnnotation()

◆ annotationAboutToBeRemoved

◆ annotationAdded

◆ annotationRemoved

◆ annotations()

◆ clear()

◆ cloneAnnotations()

◆ readXml()

◆ removeAnnotation()

◆ writeXml()