QGIS API Documentation  3.8.0-Zanzibar (11aff65)
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
QgsLayoutItemMapItemStack Class Referenceabstract

A collection of map items which are drawn above the map content in a QgsLayoutItemMap. More...

#include <qgslayoutitemmapitem.h>

Inheritance diagram for QgsLayoutItemMapItemStack:
Inheritance graph
[legend]

Public Member Functions

 QgsLayoutItemMapItemStack (QgsLayoutItemMap *map)
 Constructor for QgsLayoutItemMapItemStack, attached to the specified map. More...
 
virtual ~QgsLayoutItemMapItemStack ()
 
bool containsAdvancedEffects () const
 Returns whether any items within the stack contain advanced effects, such as blending modes. More...
 
void drawItems (QPainter *painter, bool ignoreStacking=true)
 Draws the items from the stack on a specified painter. More...
 
virtual void finalizeRestoreFromXml ()
 Called after all pending items have been restored from XML. More...
 
virtual bool readXml (const QDomElement &element, const QDomDocument &doc, const QgsReadWriteContext &context)=0
 Sets the item stack's state from a DOM document, where element is a DOM node corresponding to a 'LayoutMap' tag. More...
 
int size () const
 Returns the number of items in the stack. More...
 
virtual bool writeXml (QDomElement &element, QDomDocument &doc, const QgsReadWriteContext &context) const
 Stores the state of the item stack in a DOM node, where element is the DOM element corresponding to a 'LayoutMap' tag. More...
 

Protected Member Functions

void addItem (QgsLayoutItemMapItem *item)
 Adds a new map item to the stack and takes ownership of the item. More...
 
QList< QgsLayoutItemMapItem *> asList () const
 Returns a list of QgsLayoutItemMapItems contained by the stack. More...
 
QgsLayoutItemMapItemitem (const QString &itemId) const
 Returns a reference to an item which matching itemId within the stack. More...
 
QgsLayoutItemMapItemitem (int index) const
 Returns a reference to the item at the specified index within the stack. More...
 
void moveItemDown (const QString &itemId)
 Moves an item which matching itemId up the stack, causing it to be rendered above other items. More...
 
void moveItemUp (const QString &itemId)
 Moves an item which matching itemId up the stack, causing it to be rendered above other items. More...
 
QgsLayoutItemMapItemoperator[] (int index)
 Returns a reference to an item at the specified index within the stack. More...
 
void removeItem (const QString &itemId)
 Removes an item which matching itemId from the stack and deletes the corresponding QgsLayoutItemMapItem. More...
 
void removeItems ()
 Clears the item stack and deletes all QgsLayoutItemMapItems contained by the stack. More...
 

Protected Attributes

QList< QgsLayoutItemMapItem *> mItems
 
QgsLayoutItemMapmMap = nullptr
 

Detailed Description

A collection of map items which are drawn above the map content in a QgsLayoutItemMap.

The item stack controls which items are drawn and the order they are drawn in.

See also
QgsLayoutItemMapItem
Since
QGIS 3.0

Definition at line 210 of file qgslayoutitemmapitem.h.

Constructor & Destructor Documentation

◆ QgsLayoutItemMapItemStack()

QgsLayoutItemMapItemStack::QgsLayoutItemMapItemStack ( QgsLayoutItemMap map)

Constructor for QgsLayoutItemMapItemStack, attached to the specified map.

Definition at line 124 of file qgslayoutitemmapitem.cpp.

◆ ~QgsLayoutItemMapItemStack()

QgsLayoutItemMapItemStack::~QgsLayoutItemMapItemStack ( )
virtual

Definition at line 130 of file qgslayoutitemmapitem.cpp.

Member Function Documentation

◆ addItem()

void QgsLayoutItemMapItemStack::addItem ( QgsLayoutItemMapItem item)
protected

Adds a new map item to the stack and takes ownership of the item.

The item will be added to the end of the stack, and rendered above any existing map items already present in the stack.

Note
After adding an item to the stack update() should be called for the QgsLayoutItemMap to prevent rendering artifacts.
See also
removeItem()

Definition at line 135 of file qgslayoutitemmapitem.cpp.

◆ asList()

QList< QgsLayoutItemMapItem * > QgsLayoutItemMapItemStack::asList ( ) const
protected

Returns a list of QgsLayoutItemMapItems contained by the stack.

Definition at line 212 of file qgslayoutitemmapitem.cpp.

◆ containsAdvancedEffects()

bool QgsLayoutItemMapItemStack::containsAdvancedEffects ( ) const

Returns whether any items within the stack contain advanced effects, such as blending modes.

Definition at line 269 of file qgslayoutitemmapitem.cpp.

◆ drawItems()

void QgsLayoutItemMapItemStack::drawItems ( QPainter *  painter,
bool  ignoreStacking = true 
)

Draws the items from the stack on a specified painter.

If ignoreStacking is true, then all items will be drawn, regardless of their actual stacking position settings. If it is false, only items which are set to stack above the map item will be drawn.

Definition at line 242 of file qgslayoutitemmapitem.cpp.

◆ finalizeRestoreFromXml()

void QgsLayoutItemMapItemStack::finalizeRestoreFromXml ( )
virtual

Called after all pending items have been restored from XML.

Map item stacks 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()

Definition at line 234 of file qgslayoutitemmapitem.cpp.

◆ item() [1/2]

QgsLayoutItemMapItem * QgsLayoutItemMapItemStack::item ( const QString &  itemId) const
protected

Returns a reference to an item which matching itemId within the stack.

Definition at line 184 of file qgslayoutitemmapitem.cpp.

◆ item() [2/2]

QgsLayoutItemMapItem * QgsLayoutItemMapItemStack::item ( int  index) const
protected

Returns a reference to the item at the specified index within the stack.

Definition at line 197 of file qgslayoutitemmapitem.cpp.

◆ moveItemDown()

void QgsLayoutItemMapItemStack::moveItemDown ( const QString &  itemId)
protected

Moves an item which matching itemId up the stack, causing it to be rendered above other items.

Note
After moving an item within the stack, update() should be called for the QgsLayoutItemMap to redraw the map with the new item stack order.
See also
moveItemUp()

Definition at line 168 of file qgslayoutitemmapitem.cpp.

◆ moveItemUp()

void QgsLayoutItemMapItemStack::moveItemUp ( const QString &  itemId)
protected

Moves an item which matching itemId up the stack, causing it to be rendered above other items.

Note
After moving an item within the stack, update() should be called for the QgsLayoutItemMap to redraw the map with the new item stack order.
See also
moveItemDown()

Definition at line 152 of file qgslayoutitemmapitem.cpp.

◆ operator[]()

QgsLayoutItemMapItem & QgsLayoutItemMapItemStack::operator[] ( int  index)
protected

Returns a reference to an item at the specified index within the stack.

See also
item()
Note
not available in Python bindings

Definition at line 207 of file qgslayoutitemmapitem.cpp.

◆ readXml()

virtual bool QgsLayoutItemMapItemStack::readXml ( const QDomElement &  element,
const QDomDocument &  doc,
const QgsReadWriteContext context 
)
pure virtual

Sets the item stack's state from a DOM document, where element is a DOM node corresponding to a 'LayoutMap' tag.

Returns true if read was successful.

See also
writeXml()

Implemented in QgsLayoutItemMapGridStack, and QgsLayoutItemMapOverviewStack.

◆ removeItem()

void QgsLayoutItemMapItemStack::removeItem ( const QString &  itemId)
protected

Removes an item which matching itemId from the stack and deletes the corresponding QgsLayoutItemMapItem.

Note
After removing an item from the stack, update() should be called for the QgsLayoutItemMap to prevent rendering artifacts.
See also
addItem()

Definition at line 140 of file qgslayoutitemmapitem.cpp.

◆ removeItems()

void QgsLayoutItemMapItemStack::removeItems ( )
protected

Clears the item stack and deletes all QgsLayoutItemMapItems contained by the stack.

Definition at line 281 of file qgslayoutitemmapitem.cpp.

◆ size()

int QgsLayoutItemMapItemStack::size ( ) const
inline

Returns the number of items in the stack.

Definition at line 225 of file qgslayoutitemmapitem.h.

◆ writeXml()

bool QgsLayoutItemMapItemStack::writeXml ( QDomElement &  element,
QDomDocument &  doc,
const QgsReadWriteContext context 
) const
virtual

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

Returns true if write was successful.

See also
readXml()

Definition at line 223 of file qgslayoutitemmapitem.cpp.

Member Data Documentation

◆ mItems

QList< QgsLayoutItemMapItem * > QgsLayoutItemMapItemStack::mItems
protected

Definition at line 326 of file qgslayoutitemmapitem.h.

◆ mMap

QgsLayoutItemMap* QgsLayoutItemMapItemStack::mMap = nullptr
protected

Definition at line 328 of file qgslayoutitemmapitem.h.


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