qgslayertreeutils.h

Go to the documentation of this file.

/***************************************************************************
  qgslayertreeutils.h
  --------------------------------------
  Date                 : May 2014
  Copyright            : (C) 2014 by Martin Dobias
  Email                : wonder dot sk at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef QGSLAYERTREEUTILS_H
#define QGSLAYERTREEUTILS_H

#include <qnamespace.h>
#include <QList>
#include <QPair>

class QDomElement;
class QDomDocument;
class QStringList;

class QgsLayerTreeNode;
class QgsLayerTreeGroup;
class QgsLayerTreeLayer;
class QgsMapLayer;

class CORE_EXPORT QgsLayerTreeUtils
{
  public:

    static bool readOldLegend( QgsLayerTreeGroup* root, const QDomElement& legendElem );
    static bool readOldLegendLayerOrder( const QDomElement& legendElem, bool& hasCustomOrder, QStringList& order );
    static QDomElement writeOldLegend( QDomDocument& doc, QgsLayerTreeGroup* root, bool hasCustomOrder, const QStringList& order );

    static QString checkStateToXml( Qt::CheckState state );
    static Qt::CheckState checkStateFromXml( const QString& txt );

    static bool layersEditable( const QList<QgsLayerTreeLayer*>& layerNodes );
    static bool layersModified( const QList<QgsLayerTreeLayer*>& layerNodes );

    static void removeInvalidLayers( QgsLayerTreeGroup* group );

    static void replaceChildrenOfEmbeddedGroups( QgsLayerTreeGroup* group );

    static void updateEmbeddedGroupsProjectPath( QgsLayerTreeGroup* group );

    static QStringList invisibleLayerList( QgsLayerTreeNode *node );

    static void setLegendFilterByExpression( QgsLayerTreeLayer& layer, const QString& expr, bool enabled = true );
    static QString legendFilterByExpression( const QgsLayerTreeLayer& layer, bool* enabled = nullptr );
    static bool hasLegendFilterExpression( const QgsLayerTreeGroup& group );

    static QgsLayerTreeLayer* insertLayerBelow( QgsLayerTreeGroup* group, const QgsMapLayer* refLayer, QgsMapLayer* layerToInsert );
};

#endif // QGSLAYERTREEUTILS_H