QGIS API Documentation
3.10.0-A Coruña (6c816b4204)
|
Namespace with helper functions for layer tree operations. More...
#include <qgslayertree.h>
Signals | |
void | customLayerOrderChanged () |
Emitted when the custom layer order has changed. More... | |
void | hasCustomLayerOrderChanged (bool hasCustomLayerOrder) |
Emitted when the hasCustomLayerOrder flag changes. More... | |
void | layerOrderChanged () |
Emitted when the layer order has changed. More... | |
![]() | |
void | addedChildren (QgsLayerTreeNode *node, int indexFrom, int indexTo) |
Emitted when one or more nodes have been added to a node within the tree. More... | |
void | customPropertyChanged (QgsLayerTreeNode *node, const QString &key) |
Emitted when a custom property of a node within the tree has been changed or removed. More... | |
void | expandedChanged (QgsLayerTreeNode *node, bool expanded) |
Emitted when the collapsed/expanded state of a node within the tree has been changed. More... | |
void | nameChanged (QgsLayerTreeNode *node, QString name) |
Emitted when the name of the node is changed. More... | |
void | removedChildren (QgsLayerTreeNode *node, int indexFrom, int indexTo) |
Emitted when one or more nodes has been removed from a node within the tree. More... | |
void | visibilityChanged (QgsLayerTreeNode *node) |
Emitted when check state of a node within the tree has been changed. More... | |
void | willAddChildren (QgsLayerTreeNode *node, int indexFrom, int indexTo) |
Emitted when one or more nodes will be added to a node within the tree. More... | |
void | willRemoveChildren (QgsLayerTreeNode *node, int indexFrom, int indexTo) |
Emitted when one or more nodes will be removed from a node within the tree. More... | |
Public Member Functions | |
QgsLayerTree () | |
Create a new empty layer tree. More... | |
void | clear () |
Clear any information from this layer tree. More... | |
QgsLayerTree * | clone () const override |
Create a copy of the node. Returns new instance. More... | |
QList< QgsMapLayer * > | customLayerOrder () const |
The order in which layers will be rendered on the canvas. More... | |
bool | hasCustomLayerOrder () const |
Determines if the layer order should be derived from the layer tree or if a custom override order shall be used instead. More... | |
QList< QgsMapLayer * > | layerOrder () const |
The order in which layers will be rendered on the canvas. More... | |
void | readLayerOrderFromXml (const QDomElement &doc) |
Load the layer order from an XML element. More... | |
void | setCustomLayerOrder (const QList< QgsMapLayer *> &customLayerOrder) |
The order in which layers will be rendered on the canvas. More... | |
void | setCustomLayerOrder (const QStringList &customLayerOrder) |
The order in which layers will be rendered on the canvas. More... | |
void | setHasCustomLayerOrder (bool hasCustomLayerOrder) |
Determines if the layer order should be derived from the layer tree or if a custom override order shall be used instead. More... | |
void | writeXml (QDomElement &parentElement, const QgsReadWriteContext &context) override |
Write layer tree to XML. More... | |
![]() | |
QgsLayerTreeGroup (const QString &name=QString(), bool checked=true) | |
Constructor. More... | |
QgsLayerTreeGroup (const QgsLayerTreeGroup &other) | |
void | addChildNode (QgsLayerTreeNode *node) |
Append an existing node. More... | |
QgsLayerTreeGroup * | addGroup (const QString &name) |
Append a new group node with given name. More... | |
QgsLayerTreeLayer * | addLayer (QgsMapLayer *layer) |
Append a new layer node for given map layer. More... | |
QgsLayerTreeGroup * | clone () const override |
Returns a clone of the group. More... | |
QString | dump () const override |
Returns text representation of the tree. More... | |
QgsLayerTreeGroup * | findGroup (const QString &name) |
Find group node with specified name. More... | |
QList< QgsLayerTreeGroup * > | findGroups () const |
Find all group layer nodes. More... | |
QgsLayerTreeLayer * | findLayer (QgsMapLayer *layer) const |
Find layer node representing the map layer. More... | |
QgsLayerTreeLayer * | findLayer (const QString &layerId) const |
Find layer node representing the map layer specified by its ID. More... | |
QStringList | findLayerIds () const |
Find layer IDs used in all layer nodes. More... | |
QList< QgsLayerTreeLayer * > | findLayers () const |
Find all layer nodes. More... | |
void | insertChildNode (int index, QgsLayerTreeNode *node) |
Insert existing node at specified position. More... | |
void | insertChildNodes (int index, const QList< QgsLayerTreeNode *> &nodes) |
Insert existing nodes at specified position. More... | |
QgsLayerTreeGroup * | insertGroup (int index, const QString &name) |
Insert a new group node with given name at specified position. More... | |
QgsLayerTreeLayer * | insertLayer (int index, QgsMapLayer *layer) |
Insert a new layer node for given map layer at specified position. More... | |
bool | isMutuallyExclusive () const |
Returns whether the group is mutually exclusive (only one child can be checked at a time) More... | |
QString | name () const override |
Returns the group's name. More... | |
void | readChildrenFromXml (QDomElement &element, const QgsReadWriteContext &context) |
Read children from XML and append them to the group. More... | |
void | removeAllChildren () |
Remove all child nodes. More... | |
void | removeChildNode (QgsLayerTreeNode *node) |
Remove a child node from this group. More... | |
void | removeChildren (int from, int count) |
Remove child nodes from index "from". More... | |
void | removeChildrenGroupWithoutLayers () |
Remove all child group nodes without layers. More... | |
void | removeLayer (QgsMapLayer *layer) |
Remove map layer's node from this group. More... | |
void | resolveReferences (const QgsProject *project, bool looseMatching=false) override |
Calls resolveReferences() on child tree nodes. More... | |
void | setIsMutuallyExclusive (bool enabled, int initialChildIndex=-1) |
Set whether the group is mutually exclusive (only one child can be checked at a time). More... | |
void | setItemVisibilityCheckedRecursive (bool checked) override |
Check or uncheck a node and all its children (taking into account exclusion rules) More... | |
void | setName (const QString &n) override |
Sets the group's name. More... | |
void | writeXml (QDomElement &parentElement, const QgsReadWriteContext &context) override |
Write group (tree) as XML element <layer-tree-group> and add it to the given parent element. More... | |
![]() | |
~QgsLayerTreeNode () override | |
QList< QgsMapLayer *> | checkedLayers () const |
Returns a list of any checked layers which belong to this node or its children. More... | |
QList< QgsLayerTreeNode * > | children () |
Gets list of children of the node. Children are owned by the parent. More... | |
QList< QgsLayerTreeNode * > | children () const |
Gets list of children of the node. Children are owned by the parent. More... | |
QStringList | customProperties () const |
Returns list of keys stored in custom properties. More... | |
QVariant | customProperty (const QString &key, const QVariant &defaultValue=QVariant()) const |
Read a custom property from layer. Properties are stored in a map and saved in project file. More... | |
bool | isExpanded () const |
Returns whether the node should be shown as expanded or collapsed in GUI. More... | |
bool | isItemVisibilityCheckedRecursive () const |
Returns whether this node is checked and all its children. More... | |
bool | isItemVisibilityUncheckedRecursive () const |
Returns whether this node is unchecked and all its children. More... | |
bool | isVisible () const |
Returns whether a node is really visible (ie checked and all its ancestors checked as well) More... | |
bool | itemVisibilityChecked () const |
Returns whether a node is checked (independently of its ancestors or children) More... | |
NodeType | nodeType () const |
Find out about type of the node. It is usually shorter to use convenience functions from QgsLayerTree namespace for that. More... | |
QgsLayerTreeNode * | parent () |
Gets pointer to the parent. If parent is nullptr , the node is a root node. More... | |
void | removeCustomProperty (const QString &key) |
Remove a custom property from layer. Properties are stored in a map and saved in project file. More... | |
void | setCustomProperty (const QString &key, const QVariant &value) |
Sets a custom property for the node. Properties are stored in a map and saved in project file. More... | |
void | setExpanded (bool expanded) |
Sets whether the node should be shown as expanded or collapsed in GUI. More... | |
void | setItemVisibilityChecked (bool checked) |
Check or uncheck a node (independently of its ancestors or children) More... | |
void | setItemVisibilityCheckedParentRecursive (bool checked) |
Check or uncheck a node and all its parents. More... | |
bool | takeChild (QgsLayerTreeNode *node) |
Remove a child from a node. More... | |
Static Public Member Functions | |
static bool | isGroup (QgsLayerTreeNode *node) |
Check whether the node is a valid group node. More... | |
static bool | isLayer (const QgsLayerTreeNode *node) |
Check whether the node is a valid layer node. More... | |
static QgsLayerTree * | readXml (QDomElement &element, const QgsReadWriteContext &context) |
Load the layer tree from an XML element. More... | |
static QgsLayerTreeGroup * | toGroup (QgsLayerTreeNode *node) |
Cast node to a group. More... | |
static QgsLayerTreeLayer * | toLayer (QgsLayerTreeNode *node) |
Cast node to a layer. More... | |
static const QgsLayerTreeLayer * | toLayer (const QgsLayerTreeNode *node) |
Cast node to a layer. More... | |
![]() | |
static QgsLayerTreeGroup * | readXml (QDomElement &element, const QgsReadWriteContext &context) |
Read group (tree) from XML element <layer-tree-group> and return the newly created group (or nullptr on error). More... | |
static QgsLayerTreeGroup * | readXml (QDomElement &element, const QgsProject *project, const QgsReadWriteContext &context) |
Read group (tree) from XML element <layer-tree-group> and return the newly created group (or nullptr on error). More... | |
![]() | |
static QgsLayerTreeNode * | readXml (QDomElement &element, const QgsReadWriteContext &context) |
Read layer tree from XML. More... | |
static QgsLayerTreeNode * | readXml (QDomElement &element, const QgsProject *project) |
Read layer tree from XML. More... | |
Additional Inherited Members | |
![]() | |
enum | NodeType { NodeGroup, NodeLayer } |
Enumeration of possible tree node types. More... | |
![]() | |
void | nodeVisibilityChanged (QgsLayerTreeNode *node) |
![]() | |
void | updateChildVisibilityMutuallyExclusive () |
Set check state of children - if mutually exclusive. More... | |
![]() | |
QgsLayerTreeNode (NodeType t, bool checked=true) | |
Constructor. More... | |
QgsLayerTreeNode (const QgsLayerTreeNode &other) | |
void | insertChildrenPrivate (int index, QList< QgsLayerTreeNode *> nodes) |
Low-level insertion of children to the node. The children must not have any parent yet! More... | |
void | readCommonXml (QDomElement &element) |
Read common XML elements. More... | |
void | removeChildrenPrivate (int from, int count, bool destroy=true) |
Low-level removal of children from the node. More... | |
void | writeCommonXml (QDomElement &element) |
Write common XML elements. More... | |
![]() | |
bool | mChangingChildVisibility = false |
bool | mMutuallyExclusive = false |
Whether the group is mutually exclusive (i.e. only one child can be checked at a time) More... | |
int | mMutuallyExclusiveChildIndex = -1 |
Keeps track which child has been most recently selected (so if the whole group is unchecked and checked again, we know which child to check) More... | |
QString | mName |
![]() | |
bool | mChecked |
QList< QgsLayerTreeNode * > | mChildren |
list of children - node is responsible for their deletion More... | |
bool | mExpanded |
whether the node should be shown in GUI as expanded More... | |
NodeType | mNodeType |
type of the node - determines which subclass is used More... | |
QgsLayerTreeNode * | mParent = nullptr |
pointer to the parent node - nullptr in case of root node More... | |
QgsObjectCustomProperties | mProperties |
custom properties attached to the node More... | |
Namespace with helper functions for layer tree operations.
Only generally useful routines should be here. Miscellaneous utility functions for work with the layer tree are in QgsLayerTreeUtils class.
Definition at line 32 of file qgslayertree.h.
QgsLayerTree::QgsLayerTree | ( | ) |
Create a new empty layer tree.
Definition at line 20 of file qgslayertree.cpp.
void QgsLayerTree::clear | ( | ) |
Clear any information from this layer tree.
Definition at line 160 of file qgslayertree.cpp.
|
overridevirtual |
Create a copy of the node. Returns new instance.
Implements QgsLayerTreeNode.
Definition at line 155 of file qgslayertree.cpp.
QList< QgsMapLayer * > QgsLayerTree::customLayerOrder | ( | ) | const |
The order in which layers will be rendered on the canvas.
Will only be used if the property hasCustomLayerOrder is true
. If you need the current layer order that is active, prefer using layerOrder().
Definition at line 35 of file qgslayertree.cpp.
|
signal |
Emitted when the custom layer order has changed.
bool QgsLayerTree::hasCustomLayerOrder | ( | ) | const |
Determines if the layer order should be derived from the layer tree or if a custom override order shall be used instead.
Definition at line 98 of file qgslayertree.cpp.
|
signal |
|
inlinestatic |
Check whether the node is a valid group node.
Definition at line 43 of file qgslayertree.h.
|
inlinestatic |
Check whether the node is a valid layer node.
Definition at line 53 of file qgslayertree.h.
QList< QgsMapLayer * > QgsLayerTree::layerOrder | ( | ) | const |
The order in which layers will be rendered on the canvas.
Depending on hasCustomLayerOrder, this will return either the override customLayerOrder or the layer order derived from the tree. This property is read only.
Definition at line 75 of file qgslayertree.cpp.
|
signal |
Emitted when the layer order has changed.
void QgsLayerTree::readLayerOrderFromXml | ( | const QDomElement & | doc | ) |
Load the layer order from an XML element.
Make sure that this is only called after the layers are loaded.
Definition at line 251 of file qgslayertree.cpp.
|
static |
Load the layer tree from an XML element.
It is not required that layers are loaded at this point. resolveReferences() needs to be called after loading the layers and before using the tree.
Definition at line 114 of file qgslayertree.cpp.
void QgsLayerTree::setCustomLayerOrder | ( | const QList< QgsMapLayer *> & | customLayerOrder | ) |
The order in which layers will be rendered on the canvas.
Will only be used if the property hasCustomLayerOrder is true
. If you need the current layer order that is active, prefer using layerOrder().
Definition at line 40 of file qgslayertree.cpp.
void QgsLayerTree::setCustomLayerOrder | ( | const QStringList & | customLayerOrder | ) |
The order in which layers will be rendered on the canvas.
Will only be used if the property hasCustomLayerOrder is true
. If you need the current layer order that is active, prefer using layerOrder().
Definition at line 54 of file qgslayertree.cpp.
void QgsLayerTree::setHasCustomLayerOrder | ( | bool | hasCustomLayerOrder | ) |
Determines if the layer order should be derived from the layer tree or if a custom override order shall be used instead.
Definition at line 103 of file qgslayertree.cpp.
|
inlinestatic |
Cast node to a group.
No type checking is done - use isGroup() to find out whether this operation is legal.
Definition at line 64 of file qgslayertree.h.
|
inlinestatic |
Cast node to a layer.
No type checking is done - use isLayer() to find out whether this operation is legal.
Definition at line 75 of file qgslayertree.h.
|
inlinestatic |
Cast node to a layer.
No type checking is done - use isLayer() to find out whether this operation is legal.
Definition at line 86 of file qgslayertree.h.
|
overridevirtual |
Write layer tree to XML.
Implements QgsLayerTreeNode.
Definition at line 125 of file qgslayertree.cpp.