QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
Manages storage of a set of QgsAnnotation annotation objects. More...
#include <qgsannotationmanager.h>
Signals | |
void | annotationAboutToBeRemoved (QgsAnnotation *annotation) |
Emitted when an annotation is about to be removed from the manager. | |
void | annotationAdded (QgsAnnotation *annotation) |
Emitted when a annotation has been added to the manager. | |
void | annotationRemoved () |
Emitted when an annotation was removed from the manager. | |
Public Member Functions | |
QgsAnnotationManager (QgsProject *project=nullptr) | |
Constructor for QgsAnnotationManager. | |
~QgsAnnotationManager () override | |
bool | accept (QgsStyleEntityVisitorInterface *visitor) const |
Accepts the specified style entity visitor, causing it to visit all style entities associated within the contained annotations. | |
bool | addAnnotation (QgsAnnotation *annotation) |
Adds an annotation to the manager. | |
QList< QgsAnnotation * > | annotations () const |
Returns a list of all annotations contained in the manager. | |
void | clear () |
Removes and deletes all annotations from the manager. | |
QList< QgsAnnotation * > | cloneAnnotations () const |
Returns a list containing clones of all annotations contained in the manager. | |
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. | |
bool | readXmlAndUpgradeToAnnotationLayerItems (const QDomElement &element, const QgsReadWriteContext &context, QgsAnnotationLayer *layer, const QgsCoordinateTransformContext &transformContext) |
Reads the manager's state from a DOM element, restoring annotations present in the XML document. | |
bool | removeAnnotation (QgsAnnotation *annotation) |
Removes an annotation from the manager. | |
QDomElement | writeXml (QDomDocument &doc, const QgsReadWriteContext &context) const |
Returns a DOM element representing the state of the manager. | |
Manages storage of a set of QgsAnnotation annotation objects.
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 46 of file qgsannotationmanager.h.
|
explicit |
Constructor for QgsAnnotationManager.
The project will become the parent object for this manager.
Definition at line 30 of file qgsannotationmanager.cpp.
|
override |
Definition at line 37 of file qgsannotationmanager.cpp.
bool QgsAnnotationManager::accept | ( | QgsStyleEntityVisitorInterface * | visitor | ) | const |
Accepts the specified style entity visitor, causing it to visit all style entities associated within the contained annotations.
Returns true
if the visitor should continue visiting other objects, or false
if visiting should be canceled.
Definition at line 330 of file qgsannotationmanager.cpp.
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.
Definition at line 42 of file qgsannotationmanager.cpp.
|
signal |
Emitted when an annotation is about to be removed from the manager.
|
signal |
Emitted when a annotation has been added to the manager.
|
signal |
Emitted when an annotation was removed from the manager.
QList< QgsAnnotation * > QgsAnnotationManager::annotations | ( | ) | const |
Returns a list of all annotations contained in the manager.
Definition at line 80 of file qgsannotationmanager.cpp.
void QgsAnnotationManager::clear | ( | ) |
Removes and deletes all annotations from the manager.
Definition at line 72 of file qgsannotationmanager.cpp.
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.
Definition at line 85 of file qgsannotationmanager.cpp.
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.
Definition at line 95 of file qgsannotationmanager.cpp.
bool QgsAnnotationManager::readXmlAndUpgradeToAnnotationLayerItems | ( | const QDomElement & | element, |
const QgsReadWriteContext & | context, | ||
QgsAnnotationLayer * | layer, | ||
const QgsCoordinateTransformContext & | transformContext | ||
) |
Reads the manager's state from a DOM element, restoring annotations present in the XML document.
Annotations which can be safely converted to QgsAnnotationItem subclasses will be automatically converted to those, and stored in the specified annotation layer.
Definition at line 100 of file qgsannotationmanager.cpp.
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).
Definition at line 56 of file qgsannotationmanager.cpp.
QDomElement QgsAnnotationManager::writeXml | ( | QDomDocument & | doc, |
const QgsReadWriteContext & | context | ||
) | const |
Returns a DOM element representing the state of the manager.
Definition at line 310 of file qgsannotationmanager.cpp.