An item which is drawn inside a QgsLayoutItemMap, e.g., a grid or map overview. More...

#include <qgslayoutitemmapitem.h>

Inheritance diagram for QgsLayoutItemMapItem:

[legend]

Public Types
enum	StackingPosition { StackBelowMap , StackBelowMapLayer , StackAboveMapLayer , StackBelowMapLabels , StackAboveMapLabels }
	Item stacking position, specifies where the in the map's stack the item should be rendered. More...

Public Types inherited from QgsLayoutObject
enum	DataDefinedProperty { NoProperty = 0 , AllProperties , TestProperty , PresetPaperSize , PaperWidth , PaperHeight , NumPages , PaperOrientation , PageNumber , PositionX , PositionY , ItemWidth , ItemHeight , ItemRotation , Transparency , Opacity , BlendMode , ExcludeFromExports , FrameColor , BackgroundColor , MapRotation , MapScale , MapXMin , MapYMin , MapXMax , MapYMax , MapAtlasMargin , MapLayers , MapStylePreset , MapLabelMargin , MapGridEnabled , MapGridIntervalX , MapGridIntervalY , MapGridOffsetX , MapGridOffsetY , MapGridFrameSize , MapGridFrameMargin , MapGridLabelDistance , MapGridCrossSize , MapGridFrameLineThickness , MapGridAnnotationDisplayLeft , MapGridAnnotationDisplayRight , MapGridAnnotationDisplayTop , MapGridAnnotationDisplayBottom , MapGridFrameDivisionsLeft , MapGridFrameDivisionsRight , MapGridFrameDivisionsTop , MapGridFrameDivisionsBottom , PictureSource , PictureSvgBackgroundColor , PictureSvgStrokeColor , PictureSvgStrokeWidth , SourceUrl , LegendTitle , LegendColumnCount , ScalebarFillColor , ScalebarFillColor2 , ScalebarLineColor , ScalebarLineWidth , AttributeTableSourceLayer , MapCrs , StartDateTime , EndDateTime }
	Data defined properties for different item types. More...

enum	PropertyValueType { EvaluatedValue = 0 , OriginalValue }
	Specifies whether the value returned by a function should be the original, user set value, or the current evaluated value for the property. More...

Public Member Functions
	QgsLayoutItemMapItem (const QString &name, QgsLayoutItemMap *map)
	Constructor for QgsLayoutItemMapItem, attached to the specified map. More...

virtual bool	accept (QgsStyleEntityVisitorInterface *visitor) const
	Accepts the specified style entity visitor, causing it to visit all style entities associated with the map item. More...

QgsExpressionContext	createExpressionContext () const override
	This method needs to be reimplemented in all classes which implement this interface and return an expression context. More...

virtual void	draw (QPainter *painter)=0
	Draws the item on to a destination painter. More...

bool	enabled () const
	Returns whether the item will be drawn. More...

virtual void	finalizeRestoreFromXml ()
	Called after all pending items have been restored from XML. More...

QString	id () const
	Returns the unique id for the map item. More...

const QgsLayoutItemMap *	map () const
	Returns the layout item map for the item. More...

virtual QgsMapLayer *	mapLayer ()
	Returns the internal map layer used by this item, if available. More...

QString	name () const
	Returns the friendly display name for the item. More...

virtual bool	readXml (const QDomElement &element, const QDomDocument &doc, const QgsReadWriteContext &context)
	Sets the map item state from a DOM document, where element is the DOM node corresponding to a 'LayoutMapGrid' tag. More...

virtual void	setEnabled (bool enabled)
	Controls whether the item will be drawn. More...

void	setMap (QgsLayoutItemMap *map)
	Sets the corresponding layout map for the item. More...

void	setName (const QString &name)
	Sets the friendly display name for the item. More...

void	setStackingLayer (QgsMapLayer *layer)
	Sets the item's stacking layer, which specifies where the in the map's stack the item should be rendered. More...

void	setStackingPosition (StackingPosition position)
	Sets the item's stacking position, which specifies where the in the map's stack the item should be rendered. More...

QgsMapLayer *	stackingLayer () const
	Returns the item's stacking layer, which specifies where the in the map's stack the item should be rendered. More...

StackingPosition	stackingPosition () const
	Returns the item's stacking position, which specifies where the in the map's stack the item should be rendered. More...

virtual bool	usesAdvancedEffects () const
	Returns `true` if the item is drawn using advanced effects, such as blend modes. More...

virtual bool	writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const
	Stores map item state in a DOM element, where element is the DOM element corresponding to a 'LayoutMap' tag. More...

Public Member Functions inherited from QgsLayoutObject
	QgsLayoutObject (QgsLayout *layout)
	Constructor for QgsLayoutObject, with the specified parent layout. More...

QgsExpressionContext	createExpressionContext () const override
	Creates an expression context relating to the objects' current state. More...

QStringList	customProperties () const
	Returns list of keys stored in custom properties for the object. More...

QVariant	customProperty (const QString &key, const QVariant &defaultValue=QVariant()) const
	Read a custom property from the object. More...

QgsPropertyCollection &	dataDefinedProperties ()
	Returns a reference to the object's property collection, used for data defined overrides. More...

const QgsPropertyCollection &	dataDefinedProperties () const
	Returns a reference to the object's property collection, used for data defined overrides. More...

QgsLayout *	layout ()
	Returns the layout the object is attached to. More...

const QgsLayout *	layout () const
	Returns the layout the object is attached to. More...

void	removeCustomProperty (const QString &key)
	Remove a custom property from the object. More...

void	setCustomProperty (const QString &key, const QVariant &value)
	Set a custom property for the object. More...

void	setDataDefinedProperties (const QgsPropertyCollection &collection)
	Sets the objects's property collection, used for data defined overrides. More...

Public Member Functions inherited from QgsExpressionContextGenerator
virtual	~QgsExpressionContextGenerator ()=default

Protected Attributes
bool	mEnabled
	True if item is to be displayed on map. More...

QgsLayoutItemMap *	mMap = nullptr
	Associated map. More...

QString	mName
	Friendly display name. More...

QgsMapLayerRef	mStackingLayer

StackingPosition	mStackingPosition = StackBelowMapLabels

QString	mUuid
	Unique id. More...

Protected Attributes inherited from QgsLayoutObject
QgsObjectCustomProperties	mCustomProperties
	Custom properties for object. More...

QgsPropertyCollection	mDataDefinedProperties

QPointer< QgsLayout >	mLayout

Additional Inherited Members
Public Slots inherited from QgsLayoutObject
virtual void	refresh ()
	Refreshes the object, causing a recalculation of any property overrides. More...

Signals inherited from QgsLayoutObject
void	changed ()
	Emitted when the object's properties change. More...

Static Public Member Functions inherited from QgsLayoutObject
static bool	propertyAssociatesWithParentMultiframe (DataDefinedProperty property)
	Returns `true` if the specified property key is normally associated with the parent QgsLayoutMultiFrame object instead of a child QgsLayoutFrame object. More...

static const QgsPropertiesDefinition &	propertyDefinitions ()
	Returns the layout object property definitions. More...

Protected Member Functions inherited from QgsLayoutObject
bool	readObjectPropertiesFromElement (const QDomElement &parentElement, const QDomDocument &document, const QgsReadWriteContext &context)
	Sets object properties from a DOM element. More...

bool	writeObjectPropertiesToElement (QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context) const
	Stores object properties within an XML DOM element. More...

Detailed Description

An item which is drawn inside a QgsLayoutItemMap, e.g., a grid or map overview.

Since: QGIS 3.0

Definition at line 33 of file qgslayoutitemmapitem.h.

Member Enumeration Documentation

◆ StackingPosition

enum QgsLayoutItemMapItem::StackingPosition

Item stacking position, specifies where the in the map's stack the item should be rendered.

Enumerator
StackBelowMap	Render below all map layers.
StackBelowMapLayer	Render below a specific map layer (see stackingLayer())
StackAboveMapLayer	Render above a specific map layer (see stackingLayer())
StackBelowMapLabels	Render above all map layers, but below map labels.
StackAboveMapLabels	Render above all map layers and labels.

Definition at line 40 of file qgslayoutitemmapitem.h.

Constructor & Destructor Documentation

◆ QgsLayoutItemMapItem()

QgsLayoutItemMapItem::QgsLayoutItemMapItem	(	const QString &	name,
		QgsLayoutItemMap *	map
	)

Constructor for QgsLayoutItemMapItem, attached to the specified map.

The name argument gives a friendly display name for the item.

Definition at line 23 of file qgslayoutitemmapitem.cpp.

Member Function Documentation

◆ accept()

bool QgsLayoutItemMapItem::accept ( QgsStyleEntityVisitorInterface * visitor ) const

virtual

Accepts the specified style entity visitor, causing it to visit all style entities associated with the map item.

Returns true if the visitor should continue visiting other objects, or false if visiting should be canceled.

Since: QGIS 3.10

Reimplemented in QgsLayoutItemMapOverview, and QgsLayoutItemMapGrid.

Definition at line 132 of file qgslayoutitemmapitem.cpp.

◆ createExpressionContext()

QgsExpressionContext QgsLayoutItemMapItem::createExpressionContext ( ) const

overridevirtual

This method needs to be reimplemented in all classes which implement this interface and return an expression context.

Since: QGIS 3.0

Implements QgsExpressionContextGenerator.

Definition at line 124 of file qgslayoutitemmapitem.cpp.

◆ draw()

virtual void QgsLayoutItemMapItem::draw ( QPainter * painter )

pure virtual

Draws the item on to a destination painter.

Implemented in QgsLayoutItemMapOverview, and QgsLayoutItemMapGrid.

◆ enabled()

bool QgsLayoutItemMapItem::enabled ( ) const

Returns whether the item will be drawn.

See also: setEnabled()

Definition at line 104 of file qgslayoutitemmapitem.cpp.

◆ finalizeRestoreFromXml()

void QgsLayoutItemMapItem::finalizeRestoreFromXml ( )

virtual

Called after all pending items have been restored from XML.

Map items can use this method to run steps which must take place after all items have been restored to the layout, such as connecting to signals emitted by other items, which may not have existed in the layout at the time readXml() was called. E.g. an overview can use this to connect to its linked map item after restoration from XML.

See also: readXml()

Reimplemented in QgsLayoutItemMapOverview.

Definition at line 75 of file qgslayoutitemmapitem.cpp.

◆ id()

QString QgsLayoutItemMapItem::id ( ) const

inline

Returns the unique id for the map item.

Definition at line 100 of file qgslayoutitemmapitem.h.

◆ map()

const QgsLayoutItemMap * QgsLayoutItemMapItem::map ( ) const

Returns the layout item map for the item.

See also: setMap()

Definition at line 84 of file qgslayoutitemmapitem.cpp.

◆ mapLayer()

QgsMapLayer * QgsLayoutItemMapItem::mapLayer ( )

virtual

Returns the internal map layer used by this item, if available.

Since: QGIS 3.10.1

Reimplemented in QgsLayoutItemMapOverview.

Definition at line 137 of file qgslayoutitemmapitem.cpp.

◆ name()

QString QgsLayoutItemMapItem::name ( ) const

Returns the friendly display name for the item.

See also: setName()

Definition at line 94 of file qgslayoutitemmapitem.cpp.

◆ readXml()

bool QgsLayoutItemMapItem::readXml	(	const QDomElement &	element,
		const QDomDocument &	doc,
		const QgsReadWriteContext &	context
	)

virtual

Sets the map item state from a DOM document, where element is the DOM node corresponding to a 'LayoutMapGrid' tag.

See also: writeXml()

Reimplemented in QgsLayoutItemMapOverview, and QgsLayoutItemMapGrid.

Definition at line 55 of file qgslayoutitemmapitem.cpp.

◆ setEnabled()

void QgsLayoutItemMapItem::setEnabled ( bool enabled )

virtual

Controls whether the item will be drawn.

Set enabled to true to enable drawing of the item.

See also: enabled()

Reimplemented in QgsLayoutItemMapGrid.

Definition at line 99 of file qgslayoutitemmapitem.cpp.

◆ setMap()

void QgsLayoutItemMapItem::setMap ( QgsLayoutItemMap * map )

Sets the corresponding layout map for the item.

See also: map()

Definition at line 79 of file qgslayoutitemmapitem.cpp.

◆ setName()

void QgsLayoutItemMapItem::setName ( const QString & name )

Sets the friendly display name for the item.

See also: name()

Definition at line 89 of file qgslayoutitemmapitem.cpp.

◆ setStackingLayer()

void QgsLayoutItemMapItem::setStackingLayer ( QgsMapLayer * layer )

Sets the item's stacking layer, which specifies where the in the map's stack the item should be rendered.

This setting is only used when stackingPosition() is StackBelowMapLayer or StackAboveMapLayer.

See also: stackingLayer(); setStackingPosition

Since: QGIS 3.6

Definition at line 119 of file qgslayoutitemmapitem.cpp.

◆ setStackingPosition()

void QgsLayoutItemMapItem::setStackingPosition ( StackingPosition position )

inline

Sets the item's stacking position, which specifies where the in the map's stack the item should be rendered.

See also: stackingPosition(); setStackingLayer()

Since: QGIS 3.6

Definition at line 151 of file qgslayoutitemmapitem.h.

◆ stackingLayer()

QgsMapLayer * QgsLayoutItemMapItem::stackingLayer ( ) const

Returns the item's stacking layer, which specifies where the in the map's stack the item should be rendered.

This setting is only used when stackingPosition() is StackBelowMapLayer or StackAboveMapLayer.

See also: setStackingLayer(); stackingPosition()

Since: QGIS 3.6

Definition at line 114 of file qgslayoutitemmapitem.cpp.

◆ stackingPosition()

StackingPosition QgsLayoutItemMapItem::stackingPosition ( ) const

inline

Returns the item's stacking position, which specifies where the in the map's stack the item should be rendered.

See also: setStackingPosition(); stackingLayer()

Since: QGIS 3.6

Definition at line 140 of file qgslayoutitemmapitem.h.

◆ usesAdvancedEffects()

bool QgsLayoutItemMapItem::usesAdvancedEffects ( ) const

virtual

Returns true if the item is drawn using advanced effects, such as blend modes.

Reimplemented in QgsLayoutItemMapOverview, and QgsLayoutItemMapGrid.

Definition at line 109 of file qgslayoutitemmapitem.cpp.

◆ writeXml()

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

virtual

Stores map item state in a DOM element, where element is the DOM element corresponding to a 'LayoutMap' tag.

See also: readXml()

Reimplemented in QgsLayoutItemMapOverview, and QgsLayoutItemMapGrid.

Definition at line 33 of file qgslayoutitemmapitem.cpp.

Member Data Documentation

◆ mEnabled

bool QgsLayoutItemMapItem::mEnabled

protected

True if item is to be displayed on map.

Definition at line 213 of file qgslayoutitemmapitem.h.

◆ mMap

QgsLayoutItemMap* QgsLayoutItemMapItem::mMap = nullptr

protected

Associated map.

Definition at line 207 of file qgslayoutitemmapitem.h.

◆ mName

QString QgsLayoutItemMapItem::mName

protected

Friendly display name.

Definition at line 204 of file qgslayoutitemmapitem.h.

◆ mStackingLayer

QgsMapLayerRef QgsLayoutItemMapItem::mStackingLayer

protected

Definition at line 217 of file qgslayoutitemmapitem.h.

◆ mStackingPosition

StackingPosition QgsLayoutItemMapItem::mStackingPosition = StackBelowMapLabels

protected

Definition at line 215 of file qgslayoutitemmapitem.h.

◆ mUuid

QString QgsLayoutItemMapItem::mUuid

protected

Unique id.

Definition at line 210 of file qgslayoutitemmapitem.h.

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

/build/qgis-3.20.0+99unstable/src/core/layout/qgslayoutitemmapitem.h
/build/qgis-3.20.0+99unstable/src/core/layout/qgslayoutitemmapitem.cpp

Public Types

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ StackingPosition

Constructor & Destructor Documentation

◆ QgsLayoutItemMapItem()

Member Function Documentation

◆ accept()

◆ createExpressionContext()

◆ draw()

◆ enabled()

◆ finalizeRestoreFromXml()

◆ id()

◆ map()

◆ mapLayer()

◆ name()

◆ readXml()

◆ setEnabled()

◆ setMap()

◆ setName()

◆ setStackingLayer()

◆ setStackingPosition()

◆ stackingLayer()

◆ stackingPosition()

◆ usesAdvancedEffects()

◆ writeXml()

Member Data Documentation

◆ mEnabled

◆ mMap

◆ mName

◆ mStackingLayer

◆ mStackingPosition

◆ mUuid