QGIS/python/core/symbology-ng/qgsrendererregistry.sip

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/symbology-ng/qgsrendererregistry.h                          *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 ************************************************************************/



class QgsRendererWidget /External/;

class QgsRendererAbstractMetadata
{
%Docstring
Stores metadata about one renderer class.

.. note::

   It's necessary to implement createRenderer() function.
In C++ you can use QgsRendererMetadata convenience class.
%End

%TypeHeaderCode
#include "qgsrendererregistry.h"
%End
  public:

    enum LayerType
    {
      PointLayer,
      LineLayer,
      PolygonLayer,
      All,
    };
    typedef QFlags<QgsRendererAbstractMetadata::LayerType> LayerTypes;


    QgsRendererAbstractMetadata( const QString &name, const QString &visibleName, const QIcon &icon = QIcon() );
    virtual ~QgsRendererAbstractMetadata();

    QString name() const;
%Docstring
 :rtype: str
%End
    QString visibleName() const;
%Docstring
 :rtype: str
%End

    QIcon icon() const;
%Docstring
 :rtype: QIcon
%End
    void setIcon( const QIcon &icon );

    virtual QgsRendererAbstractMetadata::LayerTypes compatibleLayerTypes() const;
%Docstring
 Returns flags indicating the types of layer the renderer is compatible with.
.. versionadded:: 2.16
 :rtype: QgsRendererAbstractMetadata.LayerTypes
%End

    virtual QgsFeatureRenderer *createRenderer( QDomElement &elem, const QgsReadWriteContext &context ) = 0 /Factory/;
%Docstring
 Return new instance of the renderer given the DOM element. Returns NULL on error.
 Pure virtual function: must be implemented in derived classes.  *
 :rtype: QgsFeatureRenderer
%End

    virtual QgsRendererWidget *createRendererWidget( QgsVectorLayer *layer, QgsStyle *style, QgsFeatureRenderer *oldRenderer ) /Factory/;
%Docstring
 Return new instance of settings widget for the renderer. Returns NULL on error.

 The ``oldRenderer`` argument may refer to previously used renderer (or it is null).
 If not null, it may be used to initialize GUI of the widget from the previous settings.
 The old renderer does not have to be of the same type as returned by createRenderer().
 When using ``oldRenderer`` make sure to make a copy of it - it will be deleted afterwards.
 :rtype: QgsRendererWidget
%End

    virtual QgsFeatureRenderer *createRendererFromSld( QDomElement &elem, QgsWkbTypes::GeometryType geomType ) /Factory/;
%Docstring
 :rtype: QgsFeatureRenderer
%End

  protected:
};


QFlags<QgsRendererAbstractMetadata::LayerType> operator|(QgsRendererAbstractMetadata::LayerType f1, QFlags<QgsRendererAbstractMetadata::LayerType> f2);




class QgsRendererMetadata : QgsRendererAbstractMetadata
{
%Docstring
Convenience metadata class that uses static functions to create renderer and its widget.
%End

%TypeHeaderCode
#include "qgsrendererregistry.h"
%End
  public:



    virtual ~QgsRendererMetadata();

    virtual QgsFeatureRenderer *createRenderer( QDomElement &elem, const QgsReadWriteContext &context ) /Factory/;
    virtual QgsRendererWidget *createRendererWidget( QgsVectorLayer *layer, QgsStyle *style, QgsFeatureRenderer *renderer ) /Factory/;
    virtual QgsFeatureRenderer *createRendererFromSld( QDomElement &elem, QgsWkbTypes::GeometryType geomType ) /Factory/;



    virtual QgsRendererAbstractMetadata::LayerTypes compatibleLayerTypes() const;

  protected:

  private:
    QgsRendererMetadata();
};



class QgsRendererRegistry
{
%Docstring
 Registry of renderers.

 QgsRendererRegistry is not usually directly created, but rather accessed through
 QgsApplication.rendererRegistry().
%End

%TypeHeaderCode
#include "qgsrendererregistry.h"
%End
  public:

    QgsRendererRegistry();
    ~QgsRendererRegistry();


    bool addRenderer( QgsRendererAbstractMetadata *metadata /Transfer/ );
%Docstring
be added (e.g., a renderer with a duplicate name already exists)
 :rtype: bool
%End

    bool removeRenderer( const QString &rendererName );
%Docstring
renderer could not be found
 :rtype: bool
%End

    QgsRendererAbstractMetadata *rendererMetadata( const QString &rendererName );
%Docstring
renderer was not found in the registry.
 :rtype: QgsRendererAbstractMetadata
%End

    QStringList renderersList( QgsRendererAbstractMetadata::LayerTypes layerTypes = QgsRendererAbstractMetadata::All ) const;
%Docstring
\param layerTypes flags to filter the renderers by compatible layer types
 :rtype: list of str
%End

    QStringList renderersList( const QgsVectorLayer *layer ) const;
%Docstring
.. versionadded:: 2.16
 :rtype: list of str
%End

  private:
    QgsRendererRegistry( const QgsRendererRegistry &rh );
};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/symbology-ng/qgsrendererregistry.h                          *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 ************************************************************************/