Remove legacy QgsLegendInterface, move still valid methods to QgisInterface

Author: wonder-sk

doc/api_break.dox

@@ -240,6 +240,11 @@ so there is no longer a need for the separate cache class. Code which previously
 should now call QgsCoordinateReferenceSystem::invalidateCache() and QgsCoordinateTransformCache::instance()->invalidateCrs( authid ).
 - QgsHttpTransaction. This class was outdated and code should be ported to native Qt or Python implementations.
 - QgsLabel and QgsLabelAttributes. Replaced by labeling based on PAL library, see QgsLabelingEngineV2.
+- QgsLegendInterface was removed. It was replaced by layer tree API (QgsLayerTreeNode class and others).
+  Methods that deal with custom actions in main window's layer tree context menu were moved to QgisInterface:
+  - addLegendLayerAction() moved to QgisInterface::addCustomActionForLayerType()
+  - addLegendLayerActionForLayer() moved to QgisInterface::addCustomActionForLayer()
+  - removeLegendLayerAction() moved to QgisInterface::removeCustomActionForLayerType()
 - QgsLegendModel was removed.
 - QgsMapCanvasMap. It is an internal class used by map canvas.
 - QgsMapRenderer. It has been replaced by QgsMapRendererJob with subclasses and QgsMapSettings.

python/gui/gui.sip

@@ -93,7 +93,6 @@
 %Include qgskeyvaluewidget.sip
 %Include qgslistwidget.sip
 %Include qgslegendfilterbutton.sip
-%Include qgslegendinterface.sip
 %Include qgslimitedrandomcolorrampdialog.sip
 %Include qgslonglongvalidator.sip
 %Include qgsludialog.sip

python/gui/qgisinterface.sip

@@ -24,13 +24,36 @@ class QgisInterface : QObject
     /** Virtual destructor */
     virtual ~QgisInterface();
 
-    /** Get pointer to legend interface */
-    virtual QgsLegendInterface* legendInterface() = 0;
-
     virtual QgsPluginManagerInterface* pluginManagerInterface() = 0;
 
     virtual QgsLayerTreeView* layerTreeView() = 0;
 
+    /** Add action to context menu for layers in the layer tree.
+     * If allLayers is true, then the action will be available for all layers of given type,
+     * otherwise the action will be available only for specific layers added with addCustomActionForLayer()
+     * after this call.
+     *
+     * If menu argument is not empty, the action will be also added to a menu within the main window,
+     * creating menu with the given name if it does not exist yet.
+     *
+     * @see removeCustomActionForLayerType()
+     * @see addCustomActionForLayer()
+     */
+    virtual void addCustomActionForLayerType( QAction* action, QString menu,
+                                              QgsMapLayer::LayerType type, bool allLayers ) = 0;
+
+    /** Add action to context menu for a specific layer in the layer tree.
+     * It is necessary to first call addCustomActionForLayerType() with allLayers=false
+     * in order for this method to have any effect.
+     * @see addCustomActionForLayerType()
+     */
+    virtual void addCustomActionForLayer( QAction* action, QgsMapLayer* layer ) = 0;
+
+    /** Remove action for layers in the layer tree previously added with addCustomActionForLayerType()
+     * @see addCustomActionForLayerType()
+     */
+    virtual bool removeCustomActionForLayerType( QAction* action ) = 0;
+
   public slots: // TODO: do these functions really need to be slots?
 
     /* Exposed functions */

python/gui/qgslegendinterface.sip

@@ -151,8 +151,6 @@ SET(QGIS_APP_SRCS
   composer/qgscompositionwidget.cpp
   composer/qgsatlascompositionwidget.cpp
 
-  legend/qgsapplegendinterface.cpp
-
   ogr/qgsogrhelperfunctions.cpp
   ogr/qgsopenvectorlayerdialog.cpp
   ogr/qgsnewogrconnection.cpp
@@ -324,8 +322,6 @@ SET (QGIS_APP_MOC_HDRS
   composer/qgscompositionwidget.h
   composer/qgsatlascompositionwidget.h
 
-  legend/qgsapplegendinterface.h
-
   ogr/qgsopenvectorlayerdialog.h
   ogr/qgsnewogrconnection.h
   ogr/qgsvectorlayersaveasdialog.h