qgslegendinterface.h

Go to the documentation of this file.

/***************************************************************************
    qgslegendinterface.h
     --------------------------------------
    Date                 : 19-Nov-2009
    Copyright            : (C) 2009 by Andres Manz
    Email                : manz dot andres 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 QGSLEGENDINTERFACE_H
#define QGSLEGENDINTERFACE_H

#include <QObject>
#include <QPair>
#include <QStringList>
#include <QModelIndex>

class QgsMapLayer;
class QTreeWidgetItem;
class QAction;

#include "qgsmaplayer.h"

//Information about relationship between groups and layers
//key: group name (or null strings for single layers without groups)
//value: containter with layer ids contained in the group
typedef QPair< QString, QList<QString> > GroupLayerInfo;

class GUI_EXPORT QgsLegendInterface : public QObject
{
    Q_OBJECT

  public:

    QgsLegendInterface();

    virtual ~QgsLegendInterface();

    virtual QStringList groups() = 0;

    virtual QList< GroupLayerInfo > groupLayerRelationship() { return QList< GroupLayerInfo >(); }

    virtual QList<QgsMapLayer *> selectedLayers( bool inDrawOrder = false ) const = 0;

    virtual QList< QgsMapLayer * > layers() const = 0;

    virtual bool groupExists( int groupIndex ) = 0;

    virtual bool isGroupExpanded( int groupIndex ) = 0;

    virtual bool isGroupVisible( int groupIndex ) = 0;

    virtual bool isLayerExpanded( QgsMapLayer * ml ) = 0;

    virtual bool isLayerVisible( QgsMapLayer * ml ) = 0;

    virtual void addLegendLayerAction( QAction* action, QString menu, QString id,
                                       QgsMapLayer::LayerType type, bool allLayers ) = 0;

    virtual void addLegendLayerActionForLayer( QAction* action, QgsMapLayer* layer ) = 0;

    virtual bool removeLegendLayerAction( QAction* action ) = 0;

    virtual QgsMapLayer* currentLayer() = 0;

    virtual bool setCurrentLayer( QgsMapLayer *layer ) = 0;

  signals:

    void groupIndexChanged( int oldIndex, int newIndex );

    /* //! emitted when group relations have changed */
    void groupRelationsChanged();

    /* //! emitted when an item (group/layer) is added */
    void itemAdded( const QModelIndex& index );

    /* //! emitted when an item (group/layer) is removed */
    void itemRemoved();

    //  the pointer to layer can be null if no layer is selected
    void currentLayerChanged( QgsMapLayer * layer );

  public slots:

    virtual int addGroup( const QString& name, bool expand = true, QTreeWidgetItem* parent = nullptr ) = 0;

    virtual int addGroup( const QString& name, bool expand, int parentIndex ) = 0;

    virtual void removeGroup( int groupIndex ) = 0;

    virtual void moveLayer( QgsMapLayer * ml, int groupIndex ) = 0;

    virtual void setGroupExpanded( int groupIndex, bool expand ) = 0;

    virtual void setLayerExpanded( QgsMapLayer * ml, bool expand ) = 0;

    virtual void setGroupVisible( int groupIndex, bool visible ) = 0;

    virtual void setLayerVisible( QgsMapLayer * ml, bool visible ) = 0;

    virtual void refreshLayerSymbology( QgsMapLayer *ml ) = 0;
};

#endif