Class: QgsLayoutItemMapGridStack

class qgis.core.QgsLayoutItemMapGridStack

Bases: QgsLayoutItemMapItemStack

A collection of grids which is drawn above the map content in a QgsLayoutItemMap. The grid stack controls which grids are drawn and the order they are drawn in.

QgsLayoutItemMapGridStack(map: QgsLayoutItemMap) Constructor for QgsLayoutItemMapGridStack, attached to the specified map.

QgsLayoutItemMapGridStack(QgsLayoutItemMapGridStack)

Methods

addGrid

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

addItem

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

asList

Returns a list of QgsLayoutItemMapGrids contained by the stack.

calculateMaxGridExtension

Calculates the maximum distance grids within the stack extend beyond the QgsLayoutItemMap's item rect.

grid

Returns a reference to a grid with matching gridId within the stack.

item

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

maxGridExtension

Calculates the maximum distance grids within the stack extend beyond the QgsLayoutItemMap's item rect.

moveGridDown

Moves a grid with matching gridId down the stack, causing it to be rendered below other grids.

moveGridUp

Moves a grid with matching gridId up the stack, causing it to be rendered above other grids.

moveItemDown

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

moveItemUp

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

readXml

param elem:

removeGrid

Removes a grid with matching gridId from the stack and deletes the corresponding QgsLayoutItemMapGrid.

removeItem

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

removeItems

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

addGrid(self, grid: QgsLayoutItemMapGrid)

Adds a new map grid to the stack and takes ownership of the grid. The grid will be added to the end of the stack, and rendered above any existing map grids already present in the stack.

Note

After adding a grid to the stack, updateBoundingRect() and update() should be called for the QgsLayoutItemMap to prevent rendering artifacts.

See also

removeGrid()

Parameters:

grid (QgsLayoutItemMapGrid) –

addItem(self, item: QgsLayoutItemMapItem)

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()

asList(self) List[QgsLayoutItemMapGrid]

Returns a list of QgsLayoutItemMapGrids contained by the stack.

Return type:

List[QgsLayoutItemMapGrid]

calculateMaxGridExtension(self) Tuple[float, float, float, float]

Calculates the maximum distance grids within the stack extend beyond the QgsLayoutItemMap’s item rect. This method calculates the distance for each side of the map item separately.

Return type:

Tuple[float, float, float, float]

grid(self, gridId: str) QgsLayoutItemMapGrid

Returns a reference to a grid with matching gridId within the stack.

grid(self, index: int) -> QgsLayoutItemMapGrid Returns a reference to a grid at the specified index within the stack.

Parameters:

gridId (str) –

Return type:

QgsLayoutItemMapGrid

item(self, index: int) QgsLayoutItemMapItem

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

item(self, itemId: str) -> QgsLayoutItemMapItem Returns a reference to an item which matching itemId within the stack.

maxGridExtension(self) float

Calculates the maximum distance grids within the stack extend beyond the QgsLayoutItemMap’s item rect.

Return type:

float

moveGridDown(self, gridId: str)

Moves a grid with matching gridId down the stack, causing it to be rendered below other grids.

Note

After moving a grid within the stack, update() should be called for the QgsLayoutItemMap to redraw the map with the new grid stack order.

See also

moveGridUp()

Parameters:

gridId (str) –

moveGridUp(self, gridId: str)

Moves a grid with matching gridId up the stack, causing it to be rendered above other grids.

Note

After moving a grid within the stack, update() should be called for the QgsLayoutItemMap to redraw the map with the new grid stack order.

See also

moveGridDown()

Parameters:

gridId (str) –

moveItemDown(self, itemId: str)

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()

moveItemUp(self, itemId: str)

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()

readXml(self, elem: QDomElement, doc: QDomDocument, context: QgsReadWriteContext) bool
Parameters:
Return type:

bool

removeGrid(self, gridId: str)

Removes a grid with matching gridId from the stack and deletes the corresponding QgsLayoutItemMapGrid.

Note

After removing a grid from the stack, updateBoundingRect() and update() should be called for the QgsLayoutItemMap to prevent rendering artifacts.

See also

addGrid()

Parameters:

gridId (str) –

removeItem(self, itemId: str)

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()

removeItems(self)

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