QGIS API Documentation
3.0.2-Girona (307d082)
|
Base class for layouts, which can contain items such as maps, labels, scalebars, etc. More...
#include <qgslayout.h>
Public Types | |
enum | UndoCommand { UndoLayoutDpi, UndoNone = -1 } |
Layout undo commands, used for collapsing undo commands. More... | |
enum | ZValues { ZPage = 0, ZItem = 1, ZGrid = 9997, ZGuide = 9998, ZSmartGuide = 9999, ZMouseHandles = 10000, ZViewTool = 10001, ZSnapIndicator = 10002 } |
Preset item z-values, to ensure correct stacking. More... | |
Public Slots | |
void | refresh () |
Forces the layout, and all items contained within it, to refresh. More... | |
void | updateBounds () |
Updates the scene bounds of the layout. More... | |
Signals | |
void | changed () |
Is emitted when properties of the layout change. More... | |
void | refreshed () |
Is emitted when the layout has been refreshed and items should also be refreshed and updated. More... | |
void | selectedItemChanged (QgsLayoutItem *selected) |
Emitted whenever the selected item changes. More... | |
void | variablesChanged () |
Emitted whenever the expression variables stored in the layout have been changed. More... | |
Public Member Functions | |
QgsLayout (QgsProject *project) | |
Construct a new layout linked to the specified project. More... | |
~QgsLayout () override | |
QList< QgsLayoutItem *> | addItemsFromXml (const QDomElement &parentElement, const QDomDocument &document, const QgsReadWriteContext &context, QPointF *position=nullptr, bool pasteInPlace=false) |
Add items from an XML representation to the layout. More... | |
void | addLayoutItem (QgsLayoutItem *item) |
Adds an item to the layout. More... | |
void | addMultiFrame (QgsLayoutMultiFrame *multiFrame) |
Adds a multiFrame to the layout. More... | |
void | clear () |
Clears the layout. More... | |
QgsLayout * | clone () const |
Creates a clone of the layout. More... | |
QgsLayoutMeasurement | convertFromLayoutUnits (const double length, const QgsUnitTypes::LayoutUnit unit) const |
Converts a length measurement from the layout's native units to a specified target unit. More... | |
QgsLayoutSize | convertFromLayoutUnits (const QSizeF &size, const QgsUnitTypes::LayoutUnit unit) const |
Converts a size from the layout's native units to a specified target unit. More... | |
QgsLayoutPoint | convertFromLayoutUnits (const QPointF &point, const QgsUnitTypes::LayoutUnit unit) const |
Converts a point from the layout's native units to a specified target unit. More... | |
double | convertToLayoutUnits (const QgsLayoutMeasurement &measurement) const |
Converts a measurement into the layout's native units. More... | |
QSizeF | convertToLayoutUnits (const QgsLayoutSize &size) const |
Converts a size into the layout's native units. More... | |
QPointF | convertToLayoutUnits (const QgsLayoutPoint &point) const |
Converts a point into the layout's native units. More... | |
QgsAbstractLayoutUndoCommand * | createCommand (const QString &text, int id=0, QUndoCommand *parent=nullptr) override |
Creates a new layout undo command with the specified text and parent. More... | |
QgsExpressionContext | createExpressionContext () const override |
Creates an expression context relating to the layout's current state. More... | |
QStringList | customProperties () const |
Return list of keys stored in custom properties for the layout. More... | |
QVariant | customProperty (const QString &key, const QVariant &defaultValue=QVariant()) const |
Read a custom property from the layout. More... | |
void | deselectAll () |
Clears any selected items in the layout. More... | |
QgsLayoutGridSettings & | gridSettings () |
Returns a reference to the layout's grid settings, which stores settings relating to grid appearance, spacing and offsets. More... | |
const QgsLayoutGridSettings & | gridSettings () const |
Returns a reference to the layout's grid settings, which stores settings relating to grid appearance, spacing and offsets. More... | |
QgsLayoutItemGroup * | groupItems (const QList< QgsLayoutItem *> &items) |
Creates a new group from a list of layout items and adds the group to the layout. More... | |
QgsLayoutGuideCollection & | guides () |
Returns a reference to the layout's guide collection, which manages page snap guides. More... | |
const QgsLayoutGuideCollection & | guides () const |
Returns a reference to the layout's guide collection, which manages page snap guides. More... | |
void | initializeDefaults () |
Initializes an empty layout, e.g. More... | |
QgsLayoutItem * | itemById (const QString &id) const |
Returns a layout item given its id. More... | |
QgsLayoutItem * | itemByTemplateUuid (const QString &uuid) const |
Returns the layout item with matching template uuid unique identifier, or a nullptr if a matching item could not be found. More... | |
QgsLayoutItem * | itemByUuid (const QString &uuid, bool includeTemplateUuids=false) const |
Returns the layout item with matching uuid unique identifier, or a nullptr if a matching item could not be found. More... | |
QgsLayoutModel * | itemsModel () |
Returns the items model attached to the layout. More... | |
QRectF | layoutBounds (bool ignorePages=false, double margin=0.0) const |
Calculates the bounds of all non-gui items in the layout. More... | |
QgsLayoutItem * | layoutItemAt (QPointF position, const bool ignoreLocked=false) const |
Returns the topmost layout item at a specified position. More... | |
QgsLayoutItem * | layoutItemAt (QPointF position, const QgsLayoutItem *belowItem, const bool ignoreLocked=false) const |
Returns the topmost layout item at a specified position which is below a specified item. More... | |
template<class T > | |
void | layoutItems (QList< T *> &itemList) const |
Returns a list of layout items of a specific type. More... | |
template<class T > | |
void | layoutObjects (QList< T *> &objectList) const |
Returns a list of layout objects (items and multiframes) of a specific type. More... | |
QList< QgsLayoutItem *> | loadFromTemplate (const QDomDocument &document, const QgsReadWriteContext &context, bool clearExisting=true, bool *ok=nullptr) |
Load a layout template document. More... | |
bool | lowerItem (QgsLayoutItem *item, bool deferUpdate=false) |
Lowers an item down the z-order. More... | |
bool | moveItemToBottom (QgsLayoutItem *item, bool deferUpdate=false) |
Lowers an item down to the bottom of the z-order. More... | |
bool | moveItemToTop (QgsLayoutItem *item, bool deferUpdate=false) |
Raises an item up to the top of the z-order. More... | |
QgsLayoutMultiFrame * | multiFrameByUuid (const QString &uuid, bool includeTemplateUuids=false) const |
Returns the layout multiframe with matching uuid unique identifier, or a nullptr if a matching multiframe could not be found. More... | |
QList< QgsLayoutMultiFrame *> | multiFrames () const |
Returns a list of multi frames contained in the layout. More... | |
QgsLayoutPageCollection * | pageCollection () |
Returns a pointer to the layout's page collection, which stores and manages page items in the layout. More... | |
const QgsLayoutPageCollection * | pageCollection () const |
Returns a pointer to the layout's page collection, which stores and manages page items in the layout. More... | |
QRectF | pageItemBounds (int page, bool visibleOnly=false) const |
Returns the bounding box of the items contained on a specified page. More... | |
QgsProject * | project () const |
The project associated with the layout. More... | |
bool | raiseItem (QgsLayoutItem *item, bool deferUpdate=false) |
Raises an item up the z-order. More... | |
virtual bool | readXml (const QDomElement &layoutElement, const QDomDocument &document, const QgsReadWriteContext &context) |
Sets the collection's state from a DOM element. More... | |
QgsLayoutItemMap * | referenceMap () const |
Returns the map item which will be used to generate corresponding world files when the layout is exported. More... | |
void | reloadSettings () |
Refreshes the layout when global layout related options change. More... | |
void | removeCustomProperty (const QString &key) |
Remove a custom property from the layout. More... | |
void | removeLayoutItem (QgsLayoutItem *item) |
Removes an item from the layout. More... | |
void | removeMultiFrame (QgsLayoutMultiFrame *multiFrame) |
Removes a multiFrame from the layout (but does not delete it). More... | |
QgsLayoutRenderContext & | renderContext () |
Returns a reference to the layout's render context, which stores information relating to the current rendering settings for the layout. More... | |
const QgsLayoutRenderContext & | renderContext () const |
Returns a reference to the layout's render context, which stores information relating to the current rendering settings for the layout. More... | |
QgsLayoutReportContext & | reportContext () |
Returns a reference to the layout's report context, which stores information relating to the current reporting context for the layout. More... | |
const QgsLayoutReportContext & | reportContext () const |
Returns a reference to the layout's report context, which stores information relating to the current reporting context for the layout. More... | |
bool | saveAsTemplate (const QString &path, const QgsReadWriteContext &context) const |
Saves the layout as a template at the given file path. More... | |
QList< QgsLayoutItem * > | selectedLayoutItems (const bool includeLockedItems=true) |
Returns list of selected layout items. More... | |
void | setCustomProperty (const QString &key, const QVariant &value) |
Set a custom property for the layout. More... | |
void | setReferenceMap (QgsLayoutItemMap *map) |
Sets the map item which will be used to generate corresponding world files when the layout is exported. More... | |
void | setSelectedItem (QgsLayoutItem *item) |
Clears any selected items and sets item as the current selection. More... | |
void | setUnits (QgsUnitTypes::LayoutUnit units) |
Sets the native measurement units for the layout. More... | |
QgsLayoutSnapper & | snapper () |
Returns a reference to the layout's snapper, which stores handles layout snap grids and lines and snapping points to the nearest matching point. More... | |
const QgsLayoutSnapper & | snapper () const |
Returns a reference to the layout's snapper, which stores handles layout snap grids and lines and snapping points to the nearest matching point. More... | |
QgsLayoutUndoStack * | undoStack () |
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's associated objects. More... | |
const QgsLayoutUndoStack * | undoStack () const |
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's associated objects. More... | |
QList< QgsLayoutItem * > | ungroupItems (QgsLayoutItemGroup *group) |
Ungroups items by removing them from an item group and removing the group from the layout. More... | |
QgsUnitTypes::LayoutUnit | units () const |
Returns the native units for the layout. More... | |
void | updateZValues (const bool addUndoCommands=true) |
Resets the z-values of items based on their position in the internal z order list. More... | |
virtual QDomElement | writeXml (QDomDocument &document, const QgsReadWriteContext &context) const |
Returns the layout's state encapsulated in a DOM element. More... | |
Public Member Functions inherited from QgsExpressionContextGenerator | |
virtual | ~QgsExpressionContextGenerator ()=default |
Public Member Functions inherited from QgsLayoutUndoObjectInterface | |
virtual | ~QgsLayoutUndoObjectInterface ()=default |
Destructor for QgsLayoutUndoObjectInterface. More... | |
Friends | |
class | QgsCompositionConverter |
class | QgsLayoutItemAddItemCommand |
class | QgsLayoutItemDeleteUndoCommand |
class | QgsLayoutItemGroupUndoCommand |
class | QgsLayoutItemUndoCommand |
class | QgsLayoutModel |
class | QgsLayoutMultiFrame |
class | QgsLayoutUndoCommand |
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
While the raw QGraphicsScene API can be used to render the contents of a QgsLayout to a QPainter, it is recommended to instead use a QgsLayoutExporter to handle rendering layouts instead. QgsLayoutExporter automatically takes care of the intracacies of preparing the layout and paint devices for correct exports, respecting various user settings such as the layout context DPI.
Definition at line 49 of file qgslayout.h.
Layout undo commands, used for collapsing undo commands.
Enumerator | |
---|---|
UndoLayoutDpi | Change layout default DPI. |
UndoNone | No command suppression. |
Definition at line 69 of file qgslayout.h.
enum QgsLayout::ZValues |
Preset item z-values, to ensure correct stacking.
Definition at line 56 of file qgslayout.h.
QgsLayout::QgsLayout | ( | QgsProject * | project | ) |
Construct a new layout linked to the specified project.
If the layout is a "new" layout (as opposed to a layout which will restore a previous state from XML) then initializeDefaults() should be called on the new layout.
Definition at line 32 of file qgslayout.cpp.
|
override |
Definition at line 46 of file qgslayout.cpp.
QList< QgsLayoutItem *> QgsLayout::addItemsFromXml | ( | const QDomElement & | parentElement, |
const QDomDocument & | document, | ||
const QgsReadWriteContext & | context, | ||
QPointF * | position = nullptr , |
||
bool | pasteInPlace = false |
||
) |
Add items from an XML representation to the layout.
Used for project file reading and pasting items from clipboard.
The position argument is optional, and if it is not specified the items will be restored to their original position from the XML serialization. If specified, the items will be positioned such that the top-left bounds of all added items is located at this position.
The pasteInPlace argument determines whether the serialized position should be respected, but remapped to the origin of the page corresponding to the page at position.
A list of the newly added items is returned.
Definition at line 953 of file qgslayout.cpp.
void QgsLayout::addLayoutItem | ( | QgsLayoutItem * | item | ) |
Adds an item to the layout.
This should be called instead of the base class addItem() method. Ownership of the item is transferred to the layout.
Definition at line 535 of file qgslayout.cpp.
void QgsLayout::addMultiFrame | ( | QgsLayoutMultiFrame * | multiFrame | ) |
Adds a multiFrame to the layout.
The object is owned by the layout until removeMultiFrame() is called.
Definition at line 567 of file qgslayout.cpp.
|
signal |
Is emitted when properties of the layout change.
This signal is only emitted for settings directly managed by the layout, and is not emitted when child items change.
void QgsLayout::clear | ( | ) |
Clears the layout.
Calling this method removes all items and pages from the layout.
Definition at line 107 of file qgslayout.cpp.
QgsLayout * QgsLayout::clone | ( | ) | const |
Creates a clone of the layout.
Ownership of the return layout is transferred to the caller.
Definition at line 79 of file qgslayout.cpp.
QgsLayoutMeasurement QgsLayout::convertFromLayoutUnits | ( | const double | length, |
const QgsUnitTypes::LayoutUnit | unit | ||
) | const |
Converts a length measurement from the layout's native units to a specified target unit.
Definition at line 340 of file qgslayout.cpp.
QgsLayoutSize QgsLayout::convertFromLayoutUnits | ( | const QSizeF & | size, |
const QgsUnitTypes::LayoutUnit | unit | ||
) | const |
Converts a size from the layout's native units to a specified target unit.
Definition at line 345 of file qgslayout.cpp.
QgsLayoutPoint QgsLayout::convertFromLayoutUnits | ( | const QPointF & | point, |
const QgsUnitTypes::LayoutUnit | unit | ||
) | const |
Converts a point from the layout's native units to a specified target unit.
Definition at line 350 of file qgslayout.cpp.
double QgsLayout::convertToLayoutUnits | ( | const QgsLayoutMeasurement & | measurement | ) | const |
Converts a measurement into the layout's native units.
Definition at line 325 of file qgslayout.cpp.
QSizeF QgsLayout::convertToLayoutUnits | ( | const QgsLayoutSize & | size | ) | const |
Converts a size into the layout's native units.
Definition at line 330 of file qgslayout.cpp.
QPointF QgsLayout::convertToLayoutUnits | ( | const QgsLayoutPoint & | point | ) | const |
Converts a point into the layout's native units.
Definition at line 335 of file qgslayout.cpp.
|
overridevirtual |
Creates a new layout undo command with the specified text and parent.
The id argument can be used to specify an id number for the source event - this is used to determine whether QUndoCommand command compression can apply to the command.
Implements QgsLayoutUndoObjectInterface.
Definition at line 728 of file qgslayout.cpp.
|
overridevirtual |
Creates an expression context relating to the layout's current state.
The context includes scopes for global, project, layout and layout context properties.
Implements QgsExpressionContextGenerator.
Reimplemented in QgsPrintLayout.
Definition at line 391 of file qgslayout.cpp.
QStringList QgsLayout::customProperties | ( | ) | const |
Return list of keys stored in custom properties for the layout.
Definition at line 421 of file qgslayout.cpp.
QVariant QgsLayout::customProperty | ( | const QString & | key, |
const QVariant & | defaultValue = QVariant() |
||
) | const |
Read a custom property from the layout.
key | property key |
defaultValue | default value to return if property with matching key does not exist |
Definition at line 411 of file qgslayout.cpp.
void QgsLayout::deselectAll | ( | ) |
Clears any selected items in the layout.
Call this method rather than QGraphicsScene::clearSelection, as the latter does not correctly emit signals to allow the layout's model to update.
Definition at line 165 of file qgslayout.cpp.
|
inline |
Returns a reference to the layout's grid settings, which stores settings relating to grid appearance, spacing and offsets.
Definition at line 418 of file qgslayout.h.
|
inline |
Returns a reference to the layout's grid settings, which stores settings relating to grid appearance, spacing and offsets.
Definition at line 424 of file qgslayout.h.
QgsLayoutItemGroup * QgsLayout::groupItems | ( | const QList< QgsLayoutItem *> & | items | ) |
Creates a new group from a list of layout items and adds the group to the layout.
If grouping was not possible, a nullptr will be returned.
Definition at line 733 of file qgslayout.cpp.
QgsLayoutGuideCollection & QgsLayout::guides | ( | ) |
Returns a reference to the layout's guide collection, which manages page snap guides.
Definition at line 381 of file qgslayout.cpp.
const QgsLayoutGuideCollection & QgsLayout::guides | ( | ) | const |
Returns a reference to the layout's guide collection, which manages page snap guides.
Definition at line 386 of file qgslayout.cpp.
void QgsLayout::initializeDefaults | ( | ) |
Initializes an empty layout, e.g.
by adding a default page to the layout. This should be called after creating a new layout.
Definition at line 98 of file qgslayout.cpp.
QgsLayoutItem * QgsLayout::itemById | ( | const QString & | id | ) | const |
Returns a layout item given its id.
Since item IDs are not necessarely unique, this function returns the first matching item found.
Definition at line 262 of file qgslayout.cpp.
QgsLayoutItem * QgsLayout::itemByTemplateUuid | ( | const QString & | uuid | ) | const |
Returns the layout item with matching template uuid unique identifier, or a nullptr if a matching item could not be found.
Unlike itemByUuid(), this method ONLY checks template UUIDs for a match.
Template UUIDs are valid only for items which have been added to an existing layout from a template. In this case the template UUID is the original item UUID at the time the template was created, vs the item's uuid() which returns the current instance of the item's unique identifier.
Note that template UUIDs are only available while a layout is being restored from XML.
Definition at line 249 of file qgslayout.cpp.
QgsLayoutItem * QgsLayout::itemByUuid | ( | const QString & | uuid, |
bool | includeTemplateUuids = false |
||
) | const |
Returns the layout item with matching uuid unique identifier, or a nullptr if a matching item could not be found.
If includeTemplateUuids is true, then item's template UUID will also be tested when trying to match the uuid. This may differ from the item's UUID for items which have been added to an existing layout from a template. In this case the template UUID returns the original item UUID at the time the template was created, vs the item's uuid() which returns the current instance of the item's unique identifier. Note that template UUIDs are only available while a layout is being restored from XML.
Definition at line 234 of file qgslayout.cpp.
QgsLayoutModel * QgsLayout::itemsModel | ( | ) |
Returns the items model attached to the layout.
Definition at line 133 of file qgslayout.cpp.
QRectF QgsLayout::layoutBounds | ( | bool | ignorePages = false , |
double | margin = 0.0 |
||
) | const |
Calculates the bounds of all non-gui items in the layout.
Ignores snap lines, mouse handles and other cosmetic items.
ignorePages | set to true to ignore page items |
margin | optional marginal (in percent, e.g., 0.05 = 5% ) to add around items |
Definition at line 465 of file qgslayout.cpp.
QgsLayoutItem * QgsLayout::layoutItemAt | ( | QPointF | position, |
const bool | ignoreLocked = false |
||
) | const |
Returns the topmost layout item at a specified position.
Ignores paper items. If ignoreLocked is set to true any locked items will be ignored.
Definition at line 289 of file qgslayout.cpp.
QgsLayoutItem * QgsLayout::layoutItemAt | ( | QPointF | position, |
const QgsLayoutItem * | belowItem, | ||
const bool | ignoreLocked = false |
||
) | const |
Returns the topmost layout item at a specified position which is below a specified item.
Ignores paper items. If ignoreLocked is set to true any locked items will be ignored.
Definition at line 294 of file qgslayout.cpp.
|
inline |
Returns a list of layout items of a specific type.
Definition at line 121 of file qgslayout.h.
|
inline |
Returns a list of layout objects (items and multiframes) of a specific type.
Definition at line 140 of file qgslayout.h.
QList< QgsLayoutItem *> QgsLayout::loadFromTemplate | ( | const QDomDocument & | document, |
const QgsReadWriteContext & | context, | ||
bool | clearExisting = true , |
||
bool * | ok = nullptr |
||
) |
Load a layout template document.
By default this method will clear all items from the existing layout and real all layout settings from the template. Setting clearExisting to false will only add new items from the template, without overwriting the existing items or layout settings.
If ok is specified, it will be set to true if the load was successful.
Returns a list of loaded items.
Definition at line 604 of file qgslayout.cpp.
bool QgsLayout::lowerItem | ( | QgsLayoutItem * | item, |
bool | deferUpdate = false |
||
) |
Lowers an item down the z-order.
Returns true if the item was successfully lowered.
If deferUpdate is true, the scene will not be visibly updated to reflect the new stacking order. This allows multiple raiseItem() calls to be made in sequence without the cost of updating the scene for each one.
Definition at line 195 of file qgslayout.cpp.
bool QgsLayout::moveItemToBottom | ( | QgsLayoutItem * | item, |
bool | deferUpdate = false |
||
) |
Lowers an item down to the bottom of the z-order.
Returns true if the item was successfully lowered. If deferUpdate is true, the scene will not be visibly updated to reflect the new stacking order. This allows multiple raiseItem() calls to be made in sequence without the cost of updating the scene for each one.
Definition at line 221 of file qgslayout.cpp.
bool QgsLayout::moveItemToTop | ( | QgsLayoutItem * | item, |
bool | deferUpdate = false |
||
) |
Raises an item up to the top of the z-order.
Returns true if the item was successfully raised.
If deferUpdate is true, the scene will not be visibly updated to reflect the new stacking order. This allows multiple raiseItem() calls to be made in sequence without the cost of updating the scene for each one.
Definition at line 208 of file qgslayout.cpp.
QgsLayoutMultiFrame * QgsLayout::multiFrameByUuid | ( | const QString & | uuid, |
bool | includeTemplateUuids = false |
||
) | const |
Returns the layout multiframe with matching uuid unique identifier, or a nullptr if a matching multiframe could not be found.
If includeTemplateUuids is true, then the multiframe's QgsLayoutMultiFrame::templateUuid() will also be tested when trying to match the uuid. Template UUIDs are valid only for items which have been added to an existing layout from a template. In this case the template UUID is the original item UUID at the time the template was created, vs the item's uuid() which returns the current instance of the item's unique identifier. Note that template UUIDs are only available while a layout is being restored from XML.
Definition at line 276 of file qgslayout.cpp.
QList< QgsLayoutMultiFrame * > QgsLayout::multiFrames | ( | ) | const |
Returns a list of multi frames contained in the layout.
Definition at line 581 of file qgslayout.cpp.
QgsLayoutPageCollection * QgsLayout::pageCollection | ( | ) |
Returns a pointer to the layout's page collection, which stores and manages page items in the layout.
Definition at line 455 of file qgslayout.cpp.
const QgsLayoutPageCollection * QgsLayout::pageCollection | ( | ) | const |
Returns a pointer to the layout's page collection, which stores and manages page items in the layout.
Definition at line 460 of file qgslayout.cpp.
QRectF QgsLayout::pageItemBounds | ( | int | page, |
bool | visibleOnly = false |
||
) | const |
Returns the bounding box of the items contained on a specified page.
A page number of 0 represents the first page in the layout.
Set visibleOnly to true to only include visible items.
The returned bounds are in layout units.
Definition at line 509 of file qgslayout.cpp.
QgsProject * QgsLayout::project | ( | ) | const |
The project associated with the layout.
Used to get access to layers, map themes, relations and various other bits. It is never null.
Definition at line 128 of file qgslayout.cpp.
bool QgsLayout::raiseItem | ( | QgsLayoutItem * | item, |
bool | deferUpdate = false |
||
) |
Raises an item up the z-order.
Returns true if the item was successfully raised.
If deferUpdate is true, the scene will not be visibly updated to reflect the new stacking order. This allows multiple raiseItem() calls to be made in sequence without the cost of updating the scene for each one.
Definition at line 182 of file qgslayout.cpp.
|
virtual |
Sets the collection's state from a DOM element.
layoutElement is the DOM node corresponding to the layout.
Reimplemented in QgsPrintLayout.
Definition at line 927 of file qgslayout.cpp.
QgsLayoutItemMap * QgsLayout::referenceMap | ( | ) | const |
Returns the map item which will be used to generate corresponding world files when the layout is exported.
If no map was explicitly set via setReferenceMap(), the largest map in the layout will be returned (or nullptr if there are no maps in the layout).
Definition at line 426 of file qgslayout.cpp.
|
slot |
Forces the layout, and all items contained within it, to refresh.
For instance, this causes maps to redraw and rebuild cached images, html items to reload their source url, and attribute tables to refresh their contents. Calling this also triggers a recalculation of all data defined attributes within the layout.
Definition at line 784 of file qgslayout.cpp.
|
signal |
Is emitted when the layout has been refreshed and items should also be refreshed and updated.
void QgsLayout::reloadSettings | ( | ) |
Refreshes the layout when global layout related options change.
Definition at line 375 of file qgslayout.cpp.
void QgsLayout::removeCustomProperty | ( | const QString & | key | ) |
Remove a custom property from the layout.
key | property key |
Definition at line 416 of file qgslayout.cpp.
void QgsLayout::removeLayoutItem | ( | QgsLayoutItem * | item | ) |
Removes an item from the layout.
This should be called instead of the base class removeItem() method. The item will also be deleted.
Definition at line 551 of file qgslayout.cpp.
void QgsLayout::removeMultiFrame | ( | QgsLayoutMultiFrame * | multiFrame | ) |
Removes a multiFrame from the layout (but does not delete it).
Definition at line 576 of file qgslayout.cpp.
QgsLayoutRenderContext & QgsLayout::renderContext | ( | ) |
Returns a reference to the layout's render context, which stores information relating to the current rendering settings for the layout.
Definition at line 355 of file qgslayout.cpp.
const QgsLayoutRenderContext & QgsLayout::renderContext | ( | ) | const |
Returns a reference to the layout's render context, which stores information relating to the current rendering settings for the layout.
Definition at line 360 of file qgslayout.cpp.
QgsLayoutReportContext & QgsLayout::reportContext | ( | ) |
Returns a reference to the layout's report context, which stores information relating to the current reporting context for the layout.
Definition at line 365 of file qgslayout.cpp.
const QgsLayoutReportContext & QgsLayout::reportContext | ( | ) | const |
Returns a reference to the layout's report context, which stores information relating to the current reporting context for the layout.
Definition at line 370 of file qgslayout.cpp.
bool QgsLayout::saveAsTemplate | ( | const QString & | path, |
const QgsReadWriteContext & | context | ||
) | const |
Saves the layout as a template at the given file path.
Returns true if save was successful.
Definition at line 586 of file qgslayout.cpp.
|
signal |
Emitted whenever the selected item changes.
If nullptr, no item is selected.
QList< QgsLayoutItem * > QgsLayout::selectedLayoutItems | ( | const bool | includeLockedItems = true | ) |
Returns list of selected layout items.
If includeLockedItems is set to true, then locked items will also be included in the returned list.
Definition at line 138 of file qgslayout.cpp.
void QgsLayout::setCustomProperty | ( | const QString & | key, |
const QVariant & | value | ||
) |
Set a custom property for the layout.
key | property key. If a property with the same key already exists it will be overwritten. |
value | property value |
Definition at line 403 of file qgslayout.cpp.
void QgsLayout::setReferenceMap | ( | QgsLayoutItemMap * | map | ) |
Sets the map item which will be used to generate corresponding world files when the layout is exported.
Definition at line 449 of file qgslayout.cpp.
void QgsLayout::setSelectedItem | ( | QgsLayoutItem * | item | ) |
Clears any selected items and sets item as the current selection.
Definition at line 155 of file qgslayout.cpp.
|
inline |
Sets the native measurement units for the layout.
These also form the default unit for measurements for the layout.
Definition at line 321 of file qgslayout.h.
|
inline |
Returns a reference to the layout's snapper, which stores handles layout snap grids and lines and snapping points to the nearest matching point.
Definition at line 406 of file qgslayout.h.
|
inline |
Returns a reference to the layout's snapper, which stores handles layout snap grids and lines and snapping points to the nearest matching point.
Definition at line 412 of file qgslayout.h.
QgsLayoutUndoStack * QgsLayout::undoStack | ( | ) |
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's associated objects.
Definition at line 681 of file qgslayout.cpp.
const QgsLayoutUndoStack * QgsLayout::undoStack | ( | ) | const |
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's associated objects.
Definition at line 686 of file qgslayout.cpp.
QList< QgsLayoutItem * > QgsLayout::ungroupItems | ( | QgsLayoutItemGroup * | group | ) |
Ungroups items by removing them from an item group and removing the group from the layout.
Child items will remain in the layout and will not be deleted.
Returns a list of the items removed from the group, or an empty list if ungrouping was not successful.
Definition at line 759 of file qgslayout.cpp.
|
inline |
Returns the native units for the layout.
Definition at line 328 of file qgslayout.h.
|
slot |
Updates the scene bounds of the layout.
Definition at line 1079 of file qgslayout.cpp.
void QgsLayout::updateZValues | ( | const bool | addUndoCommands = true | ) |
Resets the z-values of items based on their position in the internal z order list.
This should be called after any stacking changes which deferred z-order updates.
Definition at line 896 of file qgslayout.cpp.
|
signal |
Emitted whenever the expression variables stored in the layout have been changed.
|
virtual |
Returns the layout's state encapsulated in a DOM element.
Reimplemented in QgsPrintLayout.
Definition at line 803 of file qgslayout.cpp.
|
friend |
Definition at line 743 of file qgslayout.h.
|
friend |
Definition at line 736 of file qgslayout.h.
|
friend |
Definition at line 737 of file qgslayout.h.
|
friend |
Definition at line 740 of file qgslayout.h.
|
friend |
Definition at line 738 of file qgslayout.h.
|
friend |
Definition at line 741 of file qgslayout.h.
|
friend |
Definition at line 742 of file qgslayout.h.
|
friend |
Definition at line 739 of file qgslayout.h.