Class: QgsLayoutItemMapOverview

class qgis.core.QgsLayoutItemMapOverview(name: str, map: QgsLayoutItemMap)

Bases: QgsLayoutItemMapItem

Constructor for QgsLayoutItemMapOverview.

Parameters

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

Methods

accept

param visitor

asMapLayer

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

blendMode

Retrieves the blending mode used for drawing the overview.

centered

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

childEvent

connectNotify

connectSignals

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

customEvent

disconnectNotify

draw

param painter

finalizeRestoreFromXml

frameSymbol

Returns the fill symbol used for drawing the overview extent.

inverted

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

isSignalConnected

linkedMap

Returns the source map to show the overview extent of.

mapLayer

rtype

QgsMapLayer

overviewExtentChanged

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

readObjectPropertiesFromElement

Sets object properties from a DOM element

readXml

param itemElem

receivers

sender

senderSignalIndex

setBlendMode

Sets the blending mode used for drawing the overview.

setCentered

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

setFrameSymbol

Sets the fill symbol used for drawing the overview extent.

setInverted

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

setLinkedMap

Sets the map to show the overview extent of.

timerEvent

usesAdvancedEffects

rtype

bool

writeObjectPropertiesToElement

Stores object properties within an XML DOM element.

writeXml

param elem

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