Class: QgsLayoutItemMapOverview

class qgis.core.QgsLayoutItemMapOverview

Bases: QgsLayoutItemMapItem

An individual overview which is drawn above the map content in a QgsLayoutItemMap, and shows the extent of another QgsLayoutItemMap.

New in version 3.0.

QgsLayoutItemMapOverview(name: str, map: QgsLayoutItemMap) Constructor for QgsLayoutItemMapOverview.

Parameters:
accept(self, visitor: QgsStyleEntityVisitorInterface) bool
Parameters:

visitor (QgsStyleEntityVisitorInterface) –

Return type:

bool

asMapLayer(self) QgsVectorLayer

Returns a vector layer to render as part of the QgsLayoutItemMap render, containing a feature representing the overview extent (and with an appropriate renderer set matching the overview’s frameSymbol() ).

Ownership of the layer remain with the overview item.

New in version 3.6.

Return type:

QgsVectorLayer

blendMode(self) QPainter.CompositionMode

Retrieves the blending mode used for drawing the overview.

See also

setBlendMode()

Return type:

QPainter.CompositionMode

centered(self) bool

Returns whether the extent of the map is forced to center on the overview.

See also

setCentered()

Return type:

bool

childEvent(self, QChildEvent)
connectNotify(self, QMetaMethod)
connectSignals(self)

Reconnects signals for overview map, so that overview correctly follows changes to source map’s extent.

customEvent(self, QEvent)
disconnectNotify(self, QMetaMethod)
draw(self, painter: QPainter)
Parameters:

painter (QPainter) –

finalizeRestoreFromXml(self)
frameSymbol(self) QgsFillSymbol

Returns the fill symbol used for drawing the overview extent.

See also

setFrameSymbol()

Return type:

QgsFillSymbol

inverted(self) bool

Returns whether the overview frame is inverted, ie, whether the shaded area is drawn outside the extent of the overview map.

See also

setInverted()

Return type:

bool

isSignalConnected(self, QMetaMethod) bool
linkedMap(self) QgsLayoutItemMap

Returns the source map to show the overview extent of.

See also

setLinkedMap()

Return type:

QgsLayoutItemMap

mapLayer(self) QgsMapLayer
Return type:

QgsMapLayer

overviewExtentChanged(self)

Handles recentering of the map and redrawing of the map’s overview

readObjectPropertiesFromElement(self, parentElement: QDomElement, document: QDomDocument, context: QgsReadWriteContext) bool

Sets object properties from a DOM element

Parameters:
  • parentElement – is the parent DOM element for the object

  • document – DOM document

  • context – read write context

Returns:

True if read was successful

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

bool

receivers(self, PYQT_SIGNAL) int
sender(self) QObject
senderSignalIndex(self) int
setBlendMode(self, mode: QPainter.CompositionMode)

Sets the blending mode used for drawing the overview.

See also

blendMode()

Parameters:

mode (QPainter.CompositionMode) –

setCentered(self, centered: bool)

Sets whether the extent of the map is forced to center on the overview

See also

centered()

Parameters:

centered (bool) –

setFrameSymbol(self, symbol: QgsFillSymbol)

Sets the fill symbol used for drawing the overview extent. Ownership is transferred to the overview.

See also

frameSymbol()

Parameters:

symbol (QgsFillSymbol) –

setInverted(self, inverted: bool)

Sets whether the overview frame is inverted, ie, whether the shaded area is drawn outside the extent of the overview map.

See also

inverted()

Parameters:

inverted (bool) –

setLinkedMap(self, map: QgsLayoutItemMap)

Sets the map to show the overview extent of.

See also

linkedMap()

Parameters:

map (QgsLayoutItemMap) –

timerEvent(self, QTimerEvent)
usesAdvancedEffects(self) bool
Return type:

bool

writeObjectPropertiesToElement(self, parentElement: QDomElement, document: QDomDocument, context: QgsReadWriteContext) bool

Stores object properties within an XML DOM element.

Parameters:
  • parentElement – is the parent DOM element to store the object’s properties in

  • document – DOM document

  • context – read write context

Returns:

True if write was successful

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

bool