Class: QgsLayoutGuide

class qgis.core.QgsLayoutGuide(orientation: Qt.Orientation, position: QgsLayoutMeasurement, page: QgsLayoutItemPage)

Bases: PyQt5.QtCore.QObject

Constructor for a new guide with the specified orientation and initial position.

A layout must be set by calling setLayout() before the guide can be used. Adding the guide to a QgsLayoutGuideCollection will automatically set the corresponding layout for you.

Contains the configuration for a single snap guide used by a layout.

New in version 3.0.

Parameters
childEvent(self, QChildEvent)
connectNotify(self, QMetaMethod)
customEvent(self, QEvent)
disconnectNotify(self, QMetaMethod)
isSignalConnected(self, QMetaMethod) → bool
item(self) → QGraphicsLineItem

Returns the guide’s line item.

Return type

QGraphicsLineItem

layout(self)QgsLayout

Returns the layout the guide belongs to.

See also

setLayout()

Return type

QgsLayout

layoutPosition(self) → float

Returns the guide’s position in absolute layout units.

Return type

float

orientation(self) → Qt.Orientation

Returns the guide’s orientation.

Return type

Qt.Orientation

page(self)QgsLayoutItemPage

Returns the page the guide is contained within.

See also

setPage()

Return type

QgsLayoutItemPage

position(self)QgsLayoutMeasurement

Returns the guide’s position within the page.

The position indicates either the horizontal or vertical position of the guide, depending on the guide’s orientation().

See also

setPosition()

Return type

QgsLayoutMeasurement

positionChanged

Emitted when the guide’s position is changed. [signal]

receivers(self, PYQT_SIGNAL) → int
sender(self) → QObject
senderSignalIndex(self) → int
setLayout(self, layout: QgsLayout)

Sets the layout the guide belongs to.

Note

Adding the guide to a QgsLayoutGuideCollection will automatically set the corresponding layout for you.

See also

layout()

Parameters

layout (QgsLayout) –

setLayoutPosition(self, position: float)

Sets the guide’s position in absolute layout units.

See also

layoutPosition()

Parameters

position (float) –

setPage(self, page: QgsLayoutItemPage)

Sets the page the guide is contained within.

See also

page()

Parameters

page (QgsLayoutItemPage) –

setPosition(self, position: QgsLayoutMeasurement)

Sets the guide’s position within the page.

The position argument indicates either the horizontal or vertical position of the guide, depending on the guide’s orientation().

See also

position()

Parameters

position (QgsLayoutMeasurement) –

timerEvent(self, QTimerEvent)
update(self)

Updates the position of the guide’s line item.