qgsprocessingwidgetwrapper.h

Go to the documentation of this file.

/***************************************************************************
                         qgsprocessingwidgetwrapper.h
                         ---------------------
    begin                : August 2018
    copyright            : (C) 2018 by Nyall Dawson
    email                : nyall dot dawson 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 QGSPROCESSINGWIDGETWRAPPER_H
#define QGSPROCESSINGWIDGETWRAPPER_H
 
#include <memory>
 
#include "qgis_gui.h"
#include "qgis_sip.h"
#include "qgsprocessinggui.h"
#include "qgsprocessingwidgetcontext.h"
#include "qgsvectorlayer.h"
 
#include <QObject>
#include <QPointer>
#include <QWidget>
 
class QgsProcessingParameterDefinition;
class QgsProcessingContext;
class QgsProcessingModelerParameterWidget;
class QgsProcessingModelAlgorithm;
class QLabel;
class QgsPropertyOverrideButton;
class QgsVectorLayer;
class QgsProcessingModelAlgorithm;
class QgsMapCanvas;
class QgsProcessingAlgorithm;
class QgsProcessingAbstractParameterDefinitionWidget;
class QgsMessageBar;
class QgsBrowserGuiModel;
class QgsModelGraphicsScene;
class QgsModelDesignerDialog;
class QgsAbstractProcessingParameterWidgetWrapper;

class GUI_EXPORT QgsProcessingContextGenerator
{
  public:
    virtual QgsProcessingContext *processingContext() const = 0;
 
    virtual ~QgsProcessingContextGenerator() = default;
};

class GUI_EXPORT QgsProcessingParametersGenerator
{
  public:
    enum class Flag : int SIP_ENUM_BASETYPE( IntFlag )
    {
      SkipDefaultValueParameters = 1 << 0, 
      SkipValidation = 1 << 1,             
    };
    Q_DECLARE_FLAGS( Flags, Flag )
 
    
    virtual QVariantMap createProcessingParameters( QgsProcessingParametersGenerator::Flags flags = QgsProcessingParametersGenerator::Flags() ) = 0;
 
    virtual ~QgsProcessingParametersGenerator() = default;

    enum class ValidationResult
    {
      Valid,                  
      InvalidOutputExtension, 
      InvalidValue,           
    };

    class ParameterValidationResult
    {
      public:
        QString parameterName;

        QgsProcessingParametersGenerator::ValidationResult result = QgsProcessingParametersGenerator::ValidationResult::Valid;

        QString message;
    };
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsProcessingParametersGenerator::Flags )
 
 
#ifndef SIP_RUN
class GUI_EXPORT QgsProcessingWidgetWrapperUtils
{
  public:
    static QgsExpressionContext createExpressionContext(
      QgsProcessingContextGenerator *processingContextGenerator = nullptr,
      const QgsProcessingParameterWidgetContext &widgetContext = QgsProcessingParameterWidgetContext(),
      const QgsProcessingAlgorithm *algorithm = nullptr,
      const QgsVectorLayer *linkedLayer = nullptr
    );
};
#endif

class GUI_EXPORT QgsAbstractProcessingParameterWidgetWrapper : public QObject, public QgsExpressionContextGenerator
{
    Q_OBJECT
 
  public:
    QgsAbstractProcessingParameterWidgetWrapper(
      const QgsProcessingParameterDefinition *parameter = nullptr, Qgis::ProcessingMode type = Qgis::ProcessingMode::Standard, QObject *parent SIP_TRANSFERTHIS = nullptr
    );

    Qgis::ProcessingMode type() const;

    virtual void setWidgetContext( const QgsProcessingParameterWidgetContext &context );

    const QgsProcessingParameterWidgetContext &widgetContext() const;

    QWidget *createWrappedWidget( QgsProcessingContext &context ) SIP_TRANSFERBACK;

    QLabel *createWrappedLabel() SIP_FACTORY;

    QWidget *wrappedWidget();

    QLabel *wrappedLabel();

    const QgsProcessingParameterDefinition *parameterDefinition() const;
 
    // TODO QGIS 5.0 -- remove
#ifdef SIP_RUN
    % Property( name = param, get = parameterDefinition )
#endif

      void setParameterValue( const QVariant &value, QgsProcessingContext &context );

    QVariant parameterValue() const;

    virtual QVariantMap customProperties() const;

    virtual void registerProcessingContextGenerator( QgsProcessingContextGenerator *generator );

    void registerProcessingParametersGenerator( QgsProcessingParametersGenerator *generator );

    virtual void postInitialize( const QList<QgsAbstractProcessingParameterWidgetWrapper *> &wrappers );

    virtual int stretch() const;
 
    QgsExpressionContext createExpressionContext() const override;

    virtual void setDialog( QWidget *dialog );
 
  signals:
 
    // TODO QGIS 5.0 - remove wrapper parameter - this is kept for compatibility with 3.x API,
    // yet can easily be retrieved by checking the sender()

    void widgetValueHasChanged( QgsAbstractProcessingParameterWidgetWrapper *wrapper );
 
  protected:
    virtual QWidget *createWidget() = 0 SIP_FACTORY;

    virtual QLabel *createLabel() SIP_FACTORY;

    virtual void setWidgetValue( const QVariant &value, QgsProcessingContext &context ) = 0;

    virtual QVariant widgetValue() const = 0;

    virtual const QgsVectorLayer *linkedVectorLayer() const;
 
  protected:
    QgsProcessingContextGenerator *mProcessingContextGenerator = nullptr;
    QgsProcessingParametersGenerator *mParametersGenerator = nullptr;
    QgsProcessingParameterWidgetContext mWidgetContext;
 
  private slots:
 
    void parentLayerChanged( QgsAbstractProcessingParameterWidgetWrapper *wrapper );
 
  private:
    Qgis::ProcessingMode mType = Qgis::ProcessingMode::Standard;
    const QgsProcessingParameterDefinition *mParameterDefinition = nullptr;
 
    void setDynamicParentLayerParameter( const QgsAbstractProcessingParameterWidgetWrapper *parentWrapper );
 
    QPointer<QWidget> mWidget;
    QPointer<QgsPropertyOverrideButton> mPropertyButton;
    QPointer<QLabel> mLabel;
    std::unique_ptr<QgsVectorLayer> mDynamicLayer;
 
    friend class TestProcessingGui;
};
 

class GUI_EXPORT QgsProcessingParameterWidgetFactoryInterface
{
  public:
    virtual ~QgsProcessingParameterWidgetFactoryInterface() = default;

    virtual QString parameterType() const = 0;

    virtual QgsAbstractProcessingParameterWidgetWrapper *createWidgetWrapper( const QgsProcessingParameterDefinition *parameter, Qgis::ProcessingMode type ) = 0 SIP_FACTORY;

    virtual QgsProcessingModelerParameterWidget *createModelerWidgetWrapper(
      QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context
    );

    virtual QgsProcessingAbstractParameterDefinitionWidget *createParameterDefinitionWidget(
      QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext, const QgsProcessingParameterDefinition *definition = nullptr, const QgsProcessingAlgorithm *algorithm = nullptr
    ) SIP_TRANSFERBACK;
 
  protected:
    virtual QStringList compatibleParameterTypes() const;

    virtual QStringList compatibleOutputTypes() const;

    virtual QList<int> compatibleDataTypes( const QgsProcessingParameterDefinition *parameter ) const;

    virtual QString modelerExpressionFormatString() const;

    virtual Qgis::ProcessingModelChildParameterSource defaultModelSource( const QgsProcessingParameterDefinition *parameter ) const;
};

class GUI_EXPORT QgsProcessingHiddenWidgetWrapper : public QgsAbstractProcessingParameterWidgetWrapper
{
    Q_OBJECT
  public:
    QgsProcessingHiddenWidgetWrapper( const QgsProcessingParameterDefinition *parameter = nullptr, Qgis::ProcessingMode type = Qgis::ProcessingMode::Standard, QObject *parent SIP_TRANSFERTHIS = nullptr );
 
    void setWidgetValue( const QVariant &value, QgsProcessingContext &context ) override;
    QVariant widgetValue() const override;
 
    const QgsVectorLayer *linkedVectorLayer() const override;

    void setLinkedVectorLayer( const QgsVectorLayer *layer );
 
  protected:
    QWidget *createWidget() override;
    QLabel *createLabel() override;
 
  private:
    QVariant mValue;
    QPointer<const QgsVectorLayer> mLayer;
};
 
#endif // QGSPROCESSINGWIDGETWRAPPER_H