Class: QgsLayoutGuideCollection¶
- class qgis.core.QgsLayoutGuideCollection¶
Bases:
PyQt5.QtCore.QAbstractTableModel
,QgsLayoutSerializableObject
Stores and manages the snap guides used by a layout.
New in version 3.0.
QgsLayoutGuideCollection(layout:
QgsLayout
, pageCollection:QgsLayoutPageCollection
) Constructor forQgsLayoutGuideCollection
belonging to the specified layout, and linked to the specifiedpageCollection
.Methods
Adds a
guide
to the collection.Resets all other pages' guides to match the guides from the specified
sourcePage
.Removes all guides from the collection.
- rtype:
int
- param index:
- param index:
Returns a list of all guides contained in the collection.
Returns the list of guides contained on a matching
page
.- param section:
- rtype:
QgsLayout
Sets the collection's state from a DOM element.
Removes the specified
guide
, and deletes it.- param row:
- rtype:
int
- param index:
Sets the absolute
position
(in layout coordinates) forguide
within the layout.Sets whether the guide lines should be
visible
.- rtype:
str
Updates the position (and visibility) of all guide line items.
Returns
True
if the guide lines should be drawn.Stores the collection's state in a DOM element.
Attributes
- LayoutPositionRole = 260¶
- OrientationRole = 256¶
- PageRole = 259¶
- PositionRole = 257¶
- class Roles¶
Bases:
int
- UnitsRole = 258¶
- addGuide(self, guide: QgsLayoutGuide)¶
Adds a
guide
to the collection. Ownership of the guide is transferred to the collection, and the guide will automatically have the correct layout set.- Parameters:
guide (QgsLayoutGuide) –
- applyGuidesToAllOtherPages(self, sourcePage: int)¶
Resets all other pages’ guides to match the guides from the specified
sourcePage
.- Parameters:
sourcePage (int) –
- beginInsertColumns(self, QModelIndex, int, int)¶
- beginInsertRows(self, QModelIndex, int, int)¶
- beginMoveColumns(self, QModelIndex, int, int, QModelIndex, int) bool ¶
- beginMoveRows(self, QModelIndex, int, int, QModelIndex, int) bool ¶
- beginRemoveColumns(self, QModelIndex, int, int)¶
- beginRemoveRows(self, QModelIndex, int, int)¶
- beginResetModel(self)¶
- changePersistentIndex(self, QModelIndex, QModelIndex)¶
- changePersistentIndexList(self, Iterable[QModelIndex], Iterable[QModelIndex])¶
- childEvent(self, QChildEvent)¶
- clear(self)¶
Removes all guides from the collection.
See also
- columnCount(self, QModelIndex) int ¶
- Return type:
int
- connectNotify(self, QMetaMethod)¶
- createIndex(self, int, int, object: object = 0) QModelIndex ¶
- customEvent(self, QEvent)¶
- data(self, index: QModelIndex, role: int) Any ¶
- Parameters:
index (QModelIndex) –
role (int) –
- Return type:
Any
- decodeData(self, int, int, QModelIndex, QDataStream) bool ¶
- disconnectNotify(self, QMetaMethod)¶
- encodeData(self, Iterable[QModelIndex], QDataStream)¶
- endInsertColumns(self)¶
- endInsertRows(self)¶
- endMoveColumns(self)¶
- endMoveRows(self)¶
- endRemoveColumns(self)¶
- endRemoveRows(self)¶
- endResetModel(self)¶
- flags(self, index: QModelIndex) Qt.ItemFlags ¶
- Parameters:
index (QModelIndex) –
- Return type:
Qt.ItemFlags
- guides(self) List[QgsLayoutGuide] ¶
Returns a list of all guides contained in the collection.
guides(self, orientation: Qt.Orientation, page: int = -1) -> List[QgsLayoutGuide] Returns the list of guides contained in the collection with the specified
orientation
and on a matchingpage
. Ifpage
is -1, guides from all pages will be returned.See also
- Return type:
List[QgsLayoutGuide]
- guidesOnPage(self, page: int) List[QgsLayoutGuide] ¶
Returns the list of guides contained on a matching
page
.See also
- Parameters:
page (int) –
- Return type:
List[QgsLayoutGuide]
- headerData(self, section: int, orientation: Qt.Orientation, role: int = Qt.DisplayRole) Any ¶
- Parameters:
section (int) –
orientation (Qt.Orientation) –
role (int = Qt.DisplayRole) –
- Return type:
Any
- isSignalConnected(self, QMetaMethod) bool ¶
- persistentIndexList(self) List[QModelIndex] ¶
- readXml(self, collectionElement: QDomElement, document: QDomDocument, context: QgsReadWriteContext) bool ¶
Sets the collection’s state from a DOM element. collectionElement is the DOM node corresponding to the collection.
See also
- Parameters:
collectionElement (QDomElement) –
document (QDomDocument) –
context (QgsReadWriteContext) –
- Return type:
bool
- receivers(self, PYQT_SIGNAL) int ¶
- removeGuide(self, guide: QgsLayoutGuide)¶
Removes the specified
guide
, and deletes it.See also
- Parameters:
guide (QgsLayoutGuide) –
- removeRows(self, row: int, count: int, parent: QModelIndex = QModelIndex()) bool ¶
- Parameters:
row (int) –
count (int) –
parent (QModelIndex = QModelIndex()) –
- Return type:
bool
- resetInternalData(self)¶
- rowCount(self, QModelIndex) int ¶
- Return type:
int
- sender(self) QObject ¶
- senderSignalIndex(self) int ¶
- setData(self, index: QModelIndex, value: Any, role: int) bool ¶
- Parameters:
index (QModelIndex) –
value (Any) –
role (int) –
- Return type:
bool
- setGuideLayoutPosition(self, guide: QgsLayoutGuide, position: float)¶
Sets the absolute
position
(in layout coordinates) forguide
within the layout.- Parameters:
guide (QgsLayoutGuide) –
position (float) –
- setVisible(self, visible: bool)¶
Sets whether the guide lines should be
visible
.See also
- Parameters:
visible (bool) –
- stringType(self) str ¶
- Return type:
str
- timerEvent(self, QTimerEvent)¶
- update(self)¶
Updates the position (and visibility) of all guide line items.
- visible(self) bool ¶
Returns
True
if the guide lines should be drawn.See also
- Return type:
bool
- writeXml(self, parentElement: QDomElement, document: QDomDocument, context: QgsReadWriteContext) bool ¶
Stores the collection’s state in a DOM element. The
parentElement
should refer to the parent layout’s DOM element.See also
- Parameters:
parentElement (QDomElement) –
document (QDomDocument) –
context (QgsReadWriteContext) –
- Return type:
bool