QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
Stores and manages the snap guides used by a layout. More...
#include <qgslayoutguidecollection.h>
Public Types | |
enum class | CustomRole : int { Orientation = Qt::UserRole , Position , Units , Page , LayoutPosition } |
Model roles. More... | |
Public Member Functions | |
QgsLayoutGuideCollection (QgsLayout *layout, QgsLayoutPageCollection *pageCollection) | |
Constructor for QgsLayoutGuideCollection belonging to the specified layout, and linked to the specified pageCollection. | |
~QgsLayoutGuideCollection () override | |
void | addGuide (QgsLayoutGuide *guide) |
Adds a guide to the collection. | |
void | applyGuidesToAllOtherPages (int sourcePage) |
Resets all other pages' guides to match the guides from the specified sourcePage. | |
void | clear () |
Removes all guides from the collection. | |
int | columnCount (const QModelIndex &) const override |
QVariant | data (const QModelIndex &index, int role) const override |
Qt::ItemFlags | flags (const QModelIndex &index) const override |
QList< QgsLayoutGuide * > | guides () |
Returns a list of all guides contained in the collection. | |
QList< QgsLayoutGuide * > | guides (Qt::Orientation orientation, int page=-1) |
Returns the list of guides contained in the collection with the specified orientation and on a matching page. | |
QList< QgsLayoutGuide * > | guidesOnPage (int page) |
Returns the list of guides contained on a matching page. | |
QVariant | headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const override |
QgsLayout * | layout () override |
Returns the layout the object belongs to. | |
bool | readXml (const QDomElement &collectionElement, const QDomDocument &document, const QgsReadWriteContext &context) override |
Sets the collection's state from a DOM element. | |
void | removeGuide (QgsLayoutGuide *guide) |
Removes the specified guide, and deletes it. | |
bool | removeRows (int row, int count, const QModelIndex &parent=QModelIndex()) override |
int | rowCount (const QModelIndex &) const override |
bool | setData (const QModelIndex &index, const QVariant &value, int role) override |
void | setGuideLayoutPosition (QgsLayoutGuide *guide, double position) |
Sets the absolute position (in layout coordinates) for guide within the layout. | |
void | setVisible (bool visible) |
Sets whether the guide lines should be visible. | |
QString | stringType () const override |
Returns the object type as a string. | |
void | update () |
Updates the position (and visibility) of all guide line items. | |
bool | visible () const |
Returns true if the guide lines should be drawn. | |
bool | writeXml (QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context) const override |
Stores the collection's state in a DOM element. | |
Public Member Functions inherited from QgsLayoutSerializableObject | |
QgsAbstractLayoutUndoCommand * | createCommand (const QString &text, int id, QUndoCommand *parent=nullptr) override |
Creates a new layout undo command with the specified text and parent. | |
Public Member Functions inherited from QgsLayoutUndoObjectInterface | |
virtual | ~QgsLayoutUndoObjectInterface ()=default |
Friends | |
class | QgsLayoutGuideCollectionUndoCommand |
Stores and manages the snap guides used by a layout.
Definition at line 166 of file qgslayoutguidecollection.h.
|
strong |
Model roles.
Custom model roles.
Enumerator | |
---|---|
Orientation | Guide orientation role. |
Position | Guide position role. |
Units | Guide position units role. |
Page | Guide page role. |
LayoutPosition | Guide position in layout coordinates. |
Definition at line 183 of file qgslayoutguidecollection.h.
QgsLayoutGuideCollection::QgsLayoutGuideCollection | ( | QgsLayout * | layout, |
QgsLayoutPageCollection * | pageCollection | ||
) |
Constructor for QgsLayoutGuideCollection belonging to the specified layout, and linked to the specified pageCollection.
Definition at line 193 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 204 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::addGuide | ( | QgsLayoutGuide * | guide | ) |
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.
Definition at line 389 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::applyGuidesToAllOtherPages | ( | int | sourcePage | ) |
Resets all other pages' guides to match the guides from the specified sourcePage.
Definition at line 437 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::clear | ( | ) |
Removes all guides from the collection.
Definition at line 427 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 219 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 227 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 353 of file qgslayoutguidecollection.cpp.
QList< QgsLayoutGuide * > QgsLayoutGuideCollection::guides | ( | ) |
Returns a list of all guides contained in the collection.
Definition at line 481 of file qgslayoutguidecollection.cpp.
QList< QgsLayoutGuide * > QgsLayoutGuideCollection::guides | ( | Qt::Orientation | orientation, |
int | page = -1 |
||
) |
Returns the list of guides contained in the collection with the specified orientation and on a matching page.
If page is -1, guides from all pages will be returned.
Definition at line 486 of file qgslayoutguidecollection.cpp.
QList< QgsLayoutGuide * > QgsLayoutGuideCollection::guidesOnPage | ( | int | page | ) |
Returns the list of guides contained on a matching page.
Definition at line 499 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 360 of file qgslayoutguidecollection.cpp.
|
overridevirtual |
Returns the layout the object belongs to.
Implements QgsLayoutSerializableObject.
Definition at line 209 of file qgslayoutguidecollection.cpp.
|
overridevirtual |
Sets the collection's state from a DOM element.
collectionElement is the DOM node corresponding to the collection.
Implements QgsLayoutSerializableObject.
Definition at line 554 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::removeGuide | ( | QgsLayoutGuide * | guide | ) |
Removes the specified guide, and deletes it.
Definition at line 409 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 371 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 214 of file qgslayoutguidecollection.cpp.
|
override |
Definition at line 267 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::setGuideLayoutPosition | ( | QgsLayoutGuide * | guide, |
double | position | ||
) |
Sets the absolute position (in layout coordinates) for guide within the layout.
Definition at line 418 of file qgslayoutguidecollection.cpp.
void QgsLayoutGuideCollection::setVisible | ( | bool | visible | ) |
Sets whether the guide lines should be visible.
Definition at line 516 of file qgslayoutguidecollection.cpp.
|
inlineoverridevirtual |
Returns the object type as a string.
This string must be a unique, single word, character only representation of the item type, eg "LayoutScaleBar"
Implements QgsLayoutSerializableObject.
Definition at line 201 of file qgslayoutguidecollection.h.
void QgsLayoutGuideCollection::update | ( | ) |
Updates the position (and visibility) of all guide line items.
Definition at line 472 of file qgslayoutguidecollection.cpp.
bool QgsLayoutGuideCollection::visible | ( | ) | const |
Returns true
if the guide lines should be drawn.
Definition at line 511 of file qgslayoutguidecollection.cpp.
|
overridevirtual |
Stores the collection's state in a DOM element.
The parentElement should refer to the parent layout's DOM element.
Implements QgsLayoutSerializableObject.
Definition at line 535 of file qgslayoutguidecollection.cpp.
|
friend |
Definition at line 311 of file qgslayoutguidecollection.h.