mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-16 00:05:45 -04:00
179 lines
6.1 KiB
Plaintext
179 lines
6.1 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layertree/qgslayertreeutils.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
class QgsLayerTreeUtils
|
|
{
|
|
%Docstring(signature="appended")
|
|
Assorted functions for dealing with layer trees.
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgslayertreeutils.h"
|
|
%End
|
|
public:
|
|
|
|
static bool readOldLegend( QgsLayerTreeGroup *root, const QDomElement &legendElem );
|
|
%Docstring
|
|
Try to load layer tree from \verbatim <legend> \endverbatim tag from
|
|
project files from QGIS 2.2 and below
|
|
%End
|
|
static bool readOldLegendLayerOrder( const QDomElement &legendElem, bool &hasCustomOrder, QStringList &order );
|
|
%Docstring
|
|
Try to load custom layer order from \verbatim <legend> \endverbatim tag
|
|
from project files from QGIS 2.2 and below
|
|
%End
|
|
static QDomElement writeOldLegend( QDomDocument &doc, QgsLayerTreeGroup *root, bool hasCustomOrder, const QList<QgsMapLayer *> &order );
|
|
%Docstring
|
|
Returns \verbatim <legend> \endverbatim tag used in QGIS 2.2 and below
|
|
%End
|
|
|
|
static QString checkStateToXml( Qt::CheckState state );
|
|
%Docstring
|
|
Convert Qt.CheckState to string
|
|
%End
|
|
static Qt::CheckState checkStateFromXml( const QString &txt );
|
|
%Docstring
|
|
Convert string to Qt.CheckState
|
|
%End
|
|
|
|
static bool layersEditable( const QList<QgsLayerTreeLayer *> &layerNodes, bool ignoreLayersWhichCannotBeToggled = false );
|
|
%Docstring
|
|
Returns ``True`` if any of the specified layers is editable.
|
|
|
|
The ``ignoreLayersWhichCannotBeToggled`` argument can be used to control
|
|
whether layers which cannot have their edit states toggled by users
|
|
should be ignored or not (since QGIS 3.22).
|
|
%End
|
|
|
|
static bool layersModified( const QList<QgsLayerTreeLayer *> &layerNodes );
|
|
%Docstring
|
|
Returns ``True`` if any of the layers is modified
|
|
%End
|
|
|
|
static void removeInvalidLayers( QgsLayerTreeGroup *group );
|
|
%Docstring
|
|
Removes layer nodes that refer to invalid layers
|
|
%End
|
|
|
|
static void storeOriginalLayersProperties( QgsLayerTreeGroup *group, const QDomDocument *doc );
|
|
%Docstring
|
|
Stores in a layer's originalXmlProperties the layer properties
|
|
information
|
|
|
|
.. versionadded:: 3.6
|
|
%End
|
|
|
|
static void replaceChildrenOfEmbeddedGroups( QgsLayerTreeGroup *group );
|
|
%Docstring
|
|
Remove subtree of embedded groups and replaces it with a custom property
|
|
embedded-visible-layers
|
|
%End
|
|
|
|
static void updateEmbeddedGroupsProjectPath( QgsLayerTreeGroup *group, const QgsProject *project );
|
|
%Docstring
|
|
Updates an embedded ``group`` from a ``project``.
|
|
%End
|
|
|
|
static QStringList invisibleLayerList( QgsLayerTreeNode *node );
|
|
%Docstring
|
|
Gets invisible layers
|
|
%End
|
|
|
|
static void setLegendFilterByExpression( QgsLayerTreeLayer &layer, const QString &expr, bool enabled = true );
|
|
%Docstring
|
|
Sets the expression filter of a legend layer
|
|
%End
|
|
static QString legendFilterByExpression( const QgsLayerTreeLayer &layer, bool *enabled = 0 );
|
|
%Docstring
|
|
Returns the expression filter of a legend layer
|
|
%End
|
|
static bool hasLegendFilterExpression( const QgsLayerTreeGroup &group );
|
|
%Docstring
|
|
Test if one of the layers in a group has an expression filter
|
|
%End
|
|
|
|
static QgsLayerTreeLayer *insertLayerBelow( QgsLayerTreeGroup *group, const QgsMapLayer *refLayer, QgsMapLayer *layerToInsert );
|
|
%Docstring
|
|
Insert a :py:class:`QgsMapLayer` just below another one
|
|
|
|
:param group: the tree group where layers are (can be the root group)
|
|
:param refLayer: the reference layer
|
|
:param layerToInsert: the new layer to insert just below the reference
|
|
layer
|
|
|
|
:return: the new tree layer
|
|
%End
|
|
|
|
static QSet<QgsMapLayer *> collectMapLayersRecursive( const QList<QgsLayerTreeNode *> &nodes );
|
|
%Docstring
|
|
Returns map layers from the given list of layer tree nodes. Also
|
|
recursively visits child nodes of groups.
|
|
|
|
.. versionadded:: 3.4
|
|
%End
|
|
|
|
static int countMapLayerInTree( QgsLayerTreeNode *tree, QgsMapLayer *layer );
|
|
%Docstring
|
|
Returns how many occurrences of a map layer are there in a layer tree.
|
|
In normal situations there is at most one occurrence, but sometimes
|
|
there may be temporarily more: for example, during drag&drop, upon drop
|
|
a new layer node is created while the original dragged node is still in
|
|
the tree, resulting in two occurrences.
|
|
|
|
This is useful when deciding whether to start or stop listening to a
|
|
signal of a map layer within a layer tree and only
|
|
connecting/disconnecting when there is only one occurrence of that
|
|
layer.
|
|
|
|
.. versionadded:: 3.4
|
|
%End
|
|
|
|
static QgsLayerTreeGroup *firstGroupWithoutCustomProperty( QgsLayerTreeGroup *group, const QString &property );
|
|
%Docstring
|
|
Returns the first parent which doesn't have the given custom property or
|
|
the group itself if it doesn't hold the property
|
|
|
|
:param group: the layer tree group
|
|
:param property: the property
|
|
|
|
.. versionadded:: 3.8
|
|
%End
|
|
|
|
static QgsLayerTreeLayer *insertLayerAtOptimalPlacement( QgsLayerTreeGroup *group, QgsMapLayer *layer );
|
|
%Docstring
|
|
Inserts a ``layer`` within a given ``group`` at an optimal index
|
|
position by insuring a given layer type will always sit on top of or
|
|
below other types. From top to bottom, the stacking logic is as follow:
|
|
|
|
- vector points
|
|
- vector lines
|
|
- vector polygons
|
|
- point clouds
|
|
- meshes
|
|
- rasters
|
|
- base maps
|
|
|
|
A base map is defined as a non-gdal provider raster layer (e.g. XYZ
|
|
raster layer, vector tile layer, etc.)
|
|
|
|
.. versionadded:: 3.28
|
|
%End
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layertree/qgslayertreeutils.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|