An annotation item which renders a fill symbol for a polygon geometry. More...

#include <qgsannotationpolygonitem.h>

Inheritance diagram for QgsAnnotationPolygonItem:

Public Member Functions
	QgsAnnotationPolygonItem (QgsCurvePolygon *polygon)
	Constructor for QgsAnnotationPolygonItem, with the specified polygon geometry.

	~QgsAnnotationPolygonItem () override

Qgis::AnnotationItemEditOperationResult	applyEditV2 (QgsAbstractAnnotationItemEditOperation *operation, const QgsAnnotationItemEditContext &context) override
	Applies an edit operation to the item.

QgsRectangle	boundingBox () const override
	Returns the bounding box of the item's geographic location, in the parent layer's coordinate reference system.

QgsAnnotationPolygonItem *	clone () const override
	Returns a clone of the item.

Qgis::AnnotationItemFlags	flags () const override
	Returns item flags.

const QgsCurvePolygon *	geometry () const
	Returns the geometry of the item.

QList< QgsAnnotationItemNode >	nodesV2 (const QgsAnnotationItemEditContext &context) const override
	Returns the nodes for the item, used for editing the item.

bool	readXml (const QDomElement &element, const QgsReadWriteContext &context) override
	Reads the item's state from the given DOM element.

void	render (QgsRenderContext &context, QgsFeedback *feedback) override
	Renders the item to the specified render context.

void	setGeometry (QgsCurvePolygon *geometry)
	Sets the geometry of the item.

void	setSymbol (QgsFillSymbol *symbol)
	Sets the symbol used to render the polygon item.

const QgsFillSymbol *	symbol () const
	Returns the symbol used to render the item.

QgsAnnotationItemEditOperationTransientResults *	transientEditResultsV2 (QgsAbstractAnnotationItemEditOperation *operation, const QgsAnnotationItemEditContext &context) override
	Retrieves the results of a transient (in progress) edit operation on the item.

QString	type () const override
	Returns a unique (untranslated) string identifying the type of item.

bool	writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const override
	Writes the item's state into an XML element.

Public Member Functions inherited from QgsAnnotationItem
	QgsAnnotationItem ()

	QgsAnnotationItem (const QgsAnnotationItem &other)=delete

virtual	~QgsAnnotationItem ()

virtual Q_DECL_DEPRECATED Qgis::AnnotationItemEditOperationResult	applyEdit (QgsAbstractAnnotationItemEditOperation *operation)
	Applies an edit operation to the item.

virtual QgsRectangle	boundingBox (QgsRenderContext &context) const
	Returns the bounding box of the item's geographic location, in the parent layer's coordinate reference system.

QgsCallout *	callout () const
	Returns the item's callout renderer, responsible for drawing item callouts.

QgsGeometry	calloutAnchor () const
	Returns the callout's anchor geometry.

bool	enabled () const
	Returns `true` if the item is enabled and will be rendered in the layer.

virtual Q_DECL_DEPRECATED QList< QgsAnnotationItemNode >	nodes () const
	Returns the nodes for the item, used for editing the item.

QSizeF	offsetFromCallout () const
	Returns the (optional) offset of the annotation item from the calloutAnchor().

Qgis::RenderUnit	offsetFromCalloutUnit () const
	Returns the units for the offsetFromCallout().

QgsAnnotationItem &	operator= (const QgsAnnotationItem &other)=delete

void	setCallout (QgsCallout *callout)
	Sets the item's callout renderer, responsible for drawing item callouts.

void	setCalloutAnchor (const QgsGeometry &anchor)
	Sets the callout's anchor geometry.

void	setEnabled (bool enabled)
	Sets if the item will be rendered or not in the layer.

void	setOffsetFromCallout (const QSizeF &offset)
	Sets the offset of the annotation item from the calloutAnchor().

void	setOffsetFromCalloutUnit (Qgis::RenderUnit unit)
	Sets the unit for the offsetFromCallout().

void	setSymbologyReferenceScale (double scale)
	Sets the annotation's symbology reference scale.

void	setUseSymbologyReferenceScale (bool enabled)
	Sets whether the annotation item uses a symbology reference scale.

void	setZIndex (int index)
	Sets the item's z index, which controls the order in which annotation items are rendered in the layer.

double	symbologyReferenceScale () const
	Returns the annotation's symbology reference scale.

virtual Q_DECL_DEPRECATED QgsAnnotationItemEditOperationTransientResults *	transientEditResults (QgsAbstractAnnotationItemEditOperation *operation)
	Retrieves the results of a transient (in progress) edit operation on the item.

bool	useSymbologyReferenceScale () const
	Returns `true` if the annotation item uses a symbology reference scale.

int	zIndex () const
	Returns the item's z index, which controls the order in which annotation items are rendered in the layer.

Static Public Member Functions
static QgsAnnotationPolygonItem *	create ()
	Creates a new polygon annotation item.

Additional Inherited Members
Protected Member Functions inherited from QgsAnnotationItem
virtual void	copyCommonProperties (const QgsAnnotationItem *other)
	Copies common properties from the base class from an other item.

virtual bool	readCommonProperties (const QDomElement &element, const QgsReadWriteContext &context)
	Reads common properties from the base class from the given DOM element.

void	renderCallout (QgsRenderContext &context, const QRectF &rect, double angle, QgsCallout::QgsCalloutContext &calloutContext, QgsFeedback *feedback)
	Renders the item's callout.

virtual bool	writeCommonProperties (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const
	Writes common properties from the base class into an XML element.

Detailed Description

An annotation item which renders a fill symbol for a polygon geometry.

Since: QGIS 3.16

Definition at line 33 of file qgsannotationpolygonitem.h.

Constructor & Destructor Documentation

◆ QgsAnnotationPolygonItem()

QgsAnnotationPolygonItem::QgsAnnotationPolygonItem ( QgsCurvePolygon * polygon )

Constructor for QgsAnnotationPolygonItem, with the specified polygon geometry.

Definition at line 28 of file qgsannotationpolygonitem.cpp.

◆ ~QgsAnnotationPolygonItem()

QgsAnnotationPolygonItem::~QgsAnnotationPolygonItem ( )

overridedefault

Member Function Documentation

◆ applyEditV2()

Qgis::AnnotationItemEditOperationResult QgsAnnotationPolygonItem::applyEditV2	(	QgsAbstractAnnotationItemEditOperation *	operation,
		const QgsAnnotationItemEditContext &	context
	)

overridevirtual

Applies an edit operation to the item.

Since: QGIS 3.40

Reimplemented from QgsAnnotationItem.

Definition at line 127 of file qgsannotationpolygonitem.cpp.

◆ boundingBox()

QgsRectangle QgsAnnotationPolygonItem::boundingBox ( ) const

overridevirtual

Returns the bounding box of the item's geographic location, in the parent layer's coordinate reference system.

Implements QgsAnnotationItem.

Definition at line 235 of file qgsannotationpolygonitem.cpp.

◆ clone()

QgsAnnotationPolygonItem * QgsAnnotationPolygonItem::clone ( ) const

overridevirtual

Returns a clone of the item.

Ownership is transferred to the caller.

Implementations should include a call to copyCommonProperties() to copy the base class properties.

See also: copyCommonProperties()

Implements QgsAnnotationItem.

Definition at line 227 of file qgsannotationpolygonitem.cpp.

◆ create()

QgsAnnotationPolygonItem * QgsAnnotationPolygonItem::create ( )

static

Creates a new polygon annotation item.

Definition at line 207 of file qgsannotationpolygonitem.cpp.

◆ flags()

Qgis::AnnotationItemFlags QgsAnnotationPolygonItem::flags ( ) const

overridevirtual

Returns item flags.

Since: QGIS 3.22

Reimplemented from QgsAnnotationItem.

Definition at line 202 of file qgsannotationpolygonitem.cpp.

◆ geometry()

const QgsCurvePolygon * QgsAnnotationPolygonItem::geometry ( ) const

inline

Returns the geometry of the item.

The coordinate reference system for the polygon will be the parent layer's QgsAnnotationLayer::crs().

See also: setGeometry()

Definition at line 67 of file qgsannotationpolygonitem.h.

◆ nodesV2()

QList< QgsAnnotationItemNode > QgsAnnotationPolygonItem::nodesV2 ( const QgsAnnotationItemEditContext & context ) const

overridevirtual

Returns the nodes for the item, used for editing the item.

Since: QGIS 3.40

Reimplemented from QgsAnnotationItem.

Definition at line 100 of file qgsannotationpolygonitem.cpp.

◆ readXml()

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

overridevirtual

Reads the item's state from the given DOM element.

Implementations should include a call to readCommonProperties() to read the base class properties.

See also: writeXml(); readCommonProperties()

Implements QgsAnnotationItem.

Definition at line 212 of file qgsannotationpolygonitem.cpp.

◆ render()

void QgsAnnotationPolygonItem::render	(	QgsRenderContext &	context,
		QgsFeedback *	feedback
	)

overridevirtual

Renders the item to the specified render context.

The feedback argument can be used to detect render cancellations during expensive render operations.

Implements QgsAnnotationItem.

Definition at line 43 of file qgsannotationpolygonitem.cpp.

◆ setGeometry()

void QgsAnnotationPolygonItem::setGeometry ( QgsCurvePolygon * geometry )

Sets the geometry of the item.

The coordinate reference system for the polygon will be the parent layer's QgsAnnotationLayer::crs().

See also: geometry()

Definition at line 240 of file qgsannotationpolygonitem.cpp.

◆ setSymbol()

void QgsAnnotationPolygonItem::setSymbol ( QgsFillSymbol * symbol )

Sets the symbol used to render the polygon item.

The item takes ownership of the symbol.

See also: symbol()

Definition at line 250 of file qgsannotationpolygonitem.cpp.

◆ symbol()

const QgsFillSymbol * QgsAnnotationPolygonItem::symbol ( ) const

Returns the symbol used to render the item.

See also: setSymbol()

Definition at line 245 of file qgsannotationpolygonitem.cpp.

◆ transientEditResultsV2()

QgsAnnotationItemEditOperationTransientResults * QgsAnnotationPolygonItem::transientEditResultsV2	(	QgsAbstractAnnotationItemEditOperation *	operation,
		const QgsAnnotationItemEditContext &	context
	)

overridevirtual

Retrieves the results of a transient (in progress) edit operation on the item.

Since: QGIS 3.40

Reimplemented from QgsAnnotationItem.

Definition at line 171 of file qgsannotationpolygonitem.cpp.

◆ type()

QString QgsAnnotationPolygonItem::type ( ) const

overridevirtual

Returns a unique (untranslated) string identifying the type of item.

Implements QgsAnnotationItem.

Definition at line 38 of file qgsannotationpolygonitem.cpp.

◆ writeXml()

bool QgsAnnotationPolygonItem::writeXml	(	QDomElement &	element,
		QDomDocument &	document,
		const QgsReadWriteContext &	context
	)		const

overridevirtual

Writes the item's state into an XML element.

Implementations should include a call to writeCommonProperties() to store the base class properties.

See also: readXml(); writeCommonProperties()

Implements QgsAnnotationItem.

Definition at line 91 of file qgsannotationpolygonitem.cpp.

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

/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/core/annotations/qgsannotationpolygonitem.h
/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/core/annotations/qgsannotationpolygonitem.cpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsAnnotationPolygonItem()

◆ ~QgsAnnotationPolygonItem()

Member Function Documentation

◆ applyEditV2()

◆ boundingBox()

◆ clone()

◆ create()

◆ flags()

◆ geometry()

◆ nodesV2()

◆ readXml()

◆ render()

◆ setGeometry()

◆ setSymbol()

◆ symbol()

◆ transientEditResultsV2()

◆ type()

◆ writeXml()