QGIS API Documentation
3.18.1-Zürich (202f1bf7e5)
|
An annotation which renders the contents of an SVG file. More...
#include <qgssvgannotation.h>
Public Member Functions | |
QgsSvgAnnotation (QObject *parent=nullptr) | |
Constructor for QgsSvgAnnotation. More... | |
QgsSvgAnnotation * | clone () const override |
Clones the annotation, returning a new copy of the annotation reflecting the annotation's current state. More... | |
QString | filePath () const |
Returns the file path for the source SVG file. More... | |
void | readXml (const QDomElement &itemElem, const QgsReadWriteContext &context) override |
Restores the annotation's state from a DOM element. More... | |
void | setFilePath (const QString &file) |
Sets the file path for the source SVG file. More... | |
void | writeXml (QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override |
Writes the annotation state to a DOM element. More... | |
![]() | |
QgsAnnotation (QObject *parent=nullptr) | |
Constructor for QgsAnnotation. More... | |
virtual bool | accept (QgsStyleEntityVisitorInterface *visitor) const |
Accepts the specified style entity visitor, causing it to visit all style entities associated within the annotation. More... | |
QgsFeature | associatedFeature () const |
Returns the feature associated with the annotation, or an invalid feature if none has been set. More... | |
QgsMargins | contentsMargin () const |
Returns the margins (in millimeters) between the outside of the frame and the annotation content. More... | |
QgsFillSymbol * | fillSymbol () const |
Returns the symbol that is used for rendering the annotation frame. More... | |
Q_DECL_DEPRECATED QPointF | frameOffsetFromReferencePoint () const |
Returns the annotation's frame's offset (in pixels) from the mapPosition() reference point. More... | |
QPointF | frameOffsetFromReferencePointMm () const |
Returns the annotation's frame's offset (in millimeters) from the mapPosition() reference point. More... | |
Q_DECL_DEPRECATED QSizeF | frameSize () const |
Returns the size (in pixels) of the annotation's frame (the main area in which the annotation's content is drawn). More... | |
QSizeF | frameSizeMm () const |
Returns the size (in millimeters) of the annotation's frame (the main area in which the annotation's content is drawn). More... | |
bool | hasFixedMapPosition () const |
Returns true if the annotation is attached to a fixed map position, or false if the annotation uses a position relative to the current map extent. More... | |
bool | isVisible () const |
Returns true if the annotation is visible and should be rendered. More... | |
QgsMapLayer * | mapLayer () const |
Returns the map layer associated with the annotation. More... | |
QgsPointXY | mapPosition () const |
Returns the map position of the annotation, if it is attached to a fixed map position. More... | |
QgsCoordinateReferenceSystem | mapPositionCrs () const |
Returns the CRS of the map position, or an invalid CRS if the annotation does not have a fixed map position. More... | |
QgsMarkerSymbol * | markerSymbol () const |
Returns the symbol that is drawn at the annotation's map position. More... | |
QPointF | relativePosition () const |
Returns the relative position of the annotation, if it is not attached to a fixed map position. More... | |
void | render (QgsRenderContext &context) const |
Renders the annotation to a target render context. More... | |
virtual void | setAssociatedFeature (const QgsFeature &feature) |
Sets the feature associated with the annotation. More... | |
void | setContentsMargin (const QgsMargins &margins) |
Sets the margins (in millimeters) between the outside of the frame and the annotation content. More... | |
void | setFillSymbol (QgsFillSymbol *symbol) |
Sets the fill symbol used for rendering the annotation frame. More... | |
Q_DECL_DEPRECATED void | setFrameOffsetFromReferencePoint (QPointF offset) |
Sets the annotation's frame's offset (in pixels) from the mapPosition() reference point. More... | |
void | setFrameOffsetFromReferencePointMm (QPointF offset) |
Sets the annotation's frame's offset (in millimeters) from the mapPosition() reference point. More... | |
Q_DECL_DEPRECATED void | setFrameSize (QSizeF size) |
Sets the size (in pixels) of the annotation's frame (the main area in which the annotation's content is drawn). More... | |
void | setFrameSizeMm (QSizeF size) |
Sets the size (in millimeters) of the annotation's frame (the main area in which the annotation's content is drawn). More... | |
void | setHasFixedMapPosition (bool fixed) |
Sets whether the annotation is attached to a fixed map position, or uses a position relative to the current map extent. More... | |
void | setMapLayer (QgsMapLayer *layer) |
Sets the map layer associated with the annotation. More... | |
void | setMapPosition (const QgsPointXY &position) |
Sets the map position of the annotation, if it is attached to a fixed map position. More... | |
void | setMapPositionCrs (const QgsCoordinateReferenceSystem &crs) |
Sets the CRS of the map position. More... | |
void | setMarkerSymbol (QgsMarkerSymbol *symbol) |
Sets the symbol that is drawn at the annotation's map position. More... | |
void | setRelativePosition (QPointF position) |
Sets the relative position of the annotation, if it is not attached to a fixed map position. More... | |
void | setVisible (bool visible) |
Sets whether the annotation is visible and should be rendered. More... | |
Static Public Member Functions | |
static QgsSvgAnnotation * | create () |
Returns a new QgsSvgAnnotation object. More... | |
Protected Member Functions | |
void | renderAnnotation (QgsRenderContext &context, QSizeF size) const override |
Renders the annotation's contents to a target /a context at the specified /a size. More... | |
![]() | |
void | _readXml (const QDomElement &annotationElem, const QgsReadWriteContext &context) |
Reads common annotation properties from a DOM element. More... | |
void | _writeXml (QDomElement &itemElem, QDomDocument &doc, const QgsReadWriteContext &context) const |
Writes common annotation properties to a DOM element. More... | |
void | copyCommonProperties (QgsAnnotation *target) const |
Copies common annotation properties to the targe annotation. More... | |
virtual QSizeF | minimumFrameSize () const |
Returns the minimum frame size for the annotation. More... | |
Additional Inherited Members | |
![]() | |
void | appearanceChanged () |
Emitted whenever the annotation's appearance changes. More... | |
void | mapLayerChanged () |
Emitted when the map layer associated with the annotation changes. More... | |
void | moved () |
Emitted when the annotation's position has changed and items need to be moved to reflect this. More... | |
![]() | |
QSizeF | frameSize |
bool | hasFixedMapPosition |
QgsPointXY | mapPosition |
bool | visible |
An annotation which renders the contents of an SVG file.
Definition at line 31 of file qgssvgannotation.h.
QgsSvgAnnotation::QgsSvgAnnotation | ( | QObject * | parent = nullptr | ) |
Constructor for QgsSvgAnnotation.
Definition at line 28 of file qgssvgannotation.cpp.
|
overridevirtual |
Clones the annotation, returning a new copy of the annotation reflecting the annotation's current state.
Implements QgsAnnotation.
Definition at line 34 of file qgssvgannotation.cpp.
|
inlinestatic |
Returns a new QgsSvgAnnotation object.
Definition at line 62 of file qgssvgannotation.h.
|
inline |
Returns the file path for the source SVG file.
Definition at line 57 of file qgssvgannotation.h.
|
overridevirtual |
Restores the annotation's state from a DOM element.
Derived classes should call _readXml() within their implementation of this method.
Implements QgsAnnotation.
Definition at line 51 of file qgssvgannotation.cpp.
|
overrideprotectedvirtual |
Renders the annotation's contents to a target /a context at the specified /a size.
Derived classes should implement their custom annotation drawing logic here.
Implements QgsAnnotation.
Definition at line 62 of file qgssvgannotation.cpp.
void QgsSvgAnnotation::setFilePath | ( | const QString & | file | ) |
Sets the file path for the source SVG file.
Definition at line 94 of file qgssvgannotation.cpp.
|
overridevirtual |
Writes the annotation state to a DOM element.
Derived classes should call _writeXml() within their implementation of this method.
Implements QgsAnnotation.
Definition at line 42 of file qgssvgannotation.cpp.