QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgslayertreeregistrybridge.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslayertreeregistrybridge.cpp
3 --------------------------------------
4 Date : May 2014
5 Copyright : (C) 2014 by Martin Dobias
6 Email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
17
18#include "qgslayertree.h"
19#include "qgslayertreeutils.h"
20#include "qgsproject.h"
21#include "qgslogger.h"
22
24 : QObject( parent )
25 , mRoot( root )
26 , mProject( project )
27 , mRegistryRemovingLayers( false )
28 , mEnabled( true )
29 , mNewLayersVisible( true )
30 , mInsertionPoint( root, 0 )
31{
33 connect( mProject, qOverload<const QStringList &>( &QgsProject::layersWillBeRemoved ), this, &QgsLayerTreeRegistryBridge::layersWillBeRemoved );
34
37}
38
40{
41 mInsertionPoint.group = parentGroup;
43}
44
46{
47 mInsertionPoint = insertionPoint;
48}
49
50void QgsLayerTreeRegistryBridge::layersAdded( const QList<QgsMapLayer *> &layers )
51{
52 if ( !mEnabled )
53 return;
54
55 QList<QgsLayerTreeNode *> nodes;
56 for ( QgsMapLayer *layer : layers )
57 {
58 QgsLayerTreeLayer *nodeLayer;
60 {
62 }
63 else
64 {
65 nodeLayer = new QgsLayerTreeLayer( layer );
66 }
67
69
70 nodes << nodeLayer;
71
72 // check whether the layer is marked as embedded
73 const QString projectFile = mProject->layerIsEmbedded( nodeLayer->layerId() );
74 if ( !projectFile.isEmpty() )
75 {
76 nodeLayer->setCustomProperty( QStringLiteral( "embedded" ), 1 );
77 nodeLayer->setCustomProperty( QStringLiteral( "embedded_project" ), projectFile );
78 }
79 }
80
81 switch ( mInsertionMethod )
82 {
85 break;
87 mRoot->insertChildNodes( 0, nodes );
88 break;
90 break;
91 }
92
93 // tell other components that layers have been added - this signal is used in QGIS to auto-select the first layer
94 emit addedLayersToLayerTree( layers );
95}
96
97void QgsLayerTreeRegistryBridge::layersWillBeRemoved( const QStringList &layerIds )
98{
99 QgsDebugMsgLevel( QStringLiteral( "%1 layers will be removed, enabled:%2" ).arg( layerIds.count() ).arg( mEnabled ), 4 );
100
101 if ( !mEnabled )
102 return;
103
104 // when we start removing child nodes, the bridge would try to remove those layers from
105 // the registry _again_ in groupRemovedChildren() - this prevents it
107
108 const auto constLayerIds = layerIds;
109 for ( const QString &layerId : constLayerIds )
110 {
111 QgsLayerTreeLayer *nodeLayer = mRoot->findLayer( layerId );
112 if ( nodeLayer )
113 qobject_cast<QgsLayerTreeGroup *>( nodeLayer->parent() )->removeChildNode( nodeLayer );
114 }
115
117}
118
119
120static void _collectLayerIdsInGroup( QgsLayerTreeGroup *group, int indexFrom, int indexTo, QStringList &lst )
121{
122 for ( int i = indexFrom; i <= indexTo; ++i )
123 {
124 QgsLayerTreeNode *child = group->children().at( i );
125 if ( QgsLayerTree::isLayer( child ) )
126 {
127 lst << QgsLayerTree::toLayer( child )->layerId();
128 }
129 else if ( QgsLayerTree::isGroup( child ) )
130 {
131 _collectLayerIdsInGroup( QgsLayerTree::toGroup( child ), 0, child->children().count() - 1, lst );
132 }
133 }
134}
135
137{
139 return; // do not try to remove those layers again
140
141 Q_ASSERT( mLayerIdsForRemoval.isEmpty() );
142
143 Q_ASSERT( QgsLayerTree::isGroup( node ) );
145
146 _collectLayerIdsInGroup( group, indexFrom, indexTo, mLayerIdsForRemoval );
147}
148
150{
152 return; // do not try to remove those layers again
153
154 // remove only those that really do not exist in the tree
155 // (ignores layers that were dragged'n'dropped: 1. drop new 2. remove old)
156 QStringList toRemove;
157 const auto constMLayerIdsForRemoval = mLayerIdsForRemoval;
158 for ( const QString &layerId : constMLayerIdsForRemoval )
159 if ( !mRoot->findLayer( layerId ) )
160 toRemove << layerId;
161 mLayerIdsForRemoval.clear();
162
163 QgsDebugMsgLevel( QStringLiteral( "%1 layers will be removed" ).arg( toRemove.count() ), 4 );
164
165 // delay the removal of layers from the registry. There may be other slots connected to map layer registry's signals
166 // that might disrupt the execution flow - e.g. a processEvents() call may force update of layer tree view with
167 // semi-broken tree model
168 QMetaObject::invokeMethod( this, "removeLayersFromRegistry", Qt::QueuedConnection, Q_ARG( QStringList, toRemove ) );
169}
170
172{
173 mProject->removeMapLayers( layerIds );
174}
@ TopOfTree
Layers are added at the top of the layer tree.
@ AboveInsertionPoint
Layers are added in the tree above the insertion point.
@ OptimalInInsertionGroup
Layers are added at optimal locations across the insertion point's group.
Layer tree group node serves as a container for layers and further groups.
void insertChildNodes(int index, const QList< QgsLayerTreeNode * > &nodes)
Insert existing nodes at specified position.
QgsLayerTreeLayer * findLayer(QgsMapLayer *layer) const
Find layer node representing the map layer.
Layer tree node points to a map layer.
QString layerId() const
Returns the ID for the map layer associated with this node.
This class is a base class for nodes in a layer tree.
void removedChildren(QgsLayerTreeNode *node, int indexFrom, int indexTo)
Emitted when one or more nodes has been removed from a node within the tree.
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.
QList< QgsLayerTreeNode * > children()
Gets list of children of the node. Children are owned by the parent.
void willRemoveChildren(QgsLayerTreeNode *node, int indexFrom, int indexTo)
Emitted when one or more nodes will be removed from a node within the tree.
QgsLayerTreeNode * parent()
Gets pointer to the parent. If parent is nullptr, the node is a root node.
void setItemVisibilityChecked(bool checked)
Check or uncheck a node (independently of its ancestors or children)
void removeLayersFromRegistry(const QStringList &layerIds)
void layersWillBeRemoved(const QStringList &layerIds)
void layersAdded(const QList< QgsMapLayer * > &layers)
void addedLayersToLayerTree(const QList< QgsMapLayer * > &layers)
Tell others we have just added layers to the tree (used in QGIS to auto-select first newly added laye...
void groupWillRemoveChildren(QgsLayerTreeNode *node, int indexFrom, int indexTo)
QgsLayerTreeRegistryBridge(QgsLayerTreeGroup *root, QgsProject *project, QObject *parent=nullptr)
Create the instance that synchronizes given project with a layer tree root.
Q_DECL_DEPRECATED void setLayerInsertionPoint(QgsLayerTreeGroup *parentGroup, int index)
Set where the new layers should be inserted - can be used to follow current selection.
Qgis::LayerTreeInsertionMethod mInsertionMethod
static QgsLayerTreeLayer * insertLayerAtOptimalPlacement(QgsLayerTreeGroup *group, QgsMapLayer *layer)
Inserts a layer within a given group at an optimal index position by insuring a given layer type will...
static QgsLayerTreeLayer * toLayer(QgsLayerTreeNode *node)
Cast node to a layer.
Definition: qgslayertree.h:70
static bool isLayer(const QgsLayerTreeNode *node)
Check whether the node is a valid layer node.
Definition: qgslayertree.h:50
static bool isGroup(QgsLayerTreeNode *node)
Check whether the node is a valid group node.
Definition: qgslayertree.h:41
static QgsLayerTreeGroup * toGroup(QgsLayerTreeNode *node)
Cast node to a group.
Definition: qgslayertree.h:60
Base class for all map layer types.
Definition: qgsmaplayer.h:75
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:107
void layersWillBeRemoved(const QStringList &layerIds)
Emitted when one or more layers are about to be removed from the registry.
void removeMapLayers(const QStringList &layerIds)
Remove a set of layers from the registry by layer ID.
void legendLayersAdded(const QList< QgsMapLayer * > &layers)
Emitted, when a layer was added to the registry and the legend.
QString layerIsEmbedded(const QString &id) const
Returns the source project file path if the layer with matching id is embedded from other project fil...
#define QgsDebugMsgLevel(str, level)
Definition: qgslogger.h:39
A structure to define the insertion point to the layer tree.