QGIS API Documentation 4.3.0-Master (c0a40176c6f)
Loading...
Searching...
No Matches
qgsprocessingguiregistry.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsprocessingguiregistry.h
3 ---------------------
4 begin : April 2018
5 copyright : (C) 2018 by Matthias Kuhn
6 email : matthias@opengis.ch
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#ifndef QGSPROCESSINGGUIREGISTRY_H
19#define QGSPROCESSINGGUIREGISTRY_H
20
21#include "qgis_gui.h"
22#include "qgis_sip.h"
27
28#include <QList>
29#include <QMap>
30
38class QgsProcessingModelComponent;
39class QgsProcessingGuiInternalModelConfigWidgetFactory;
42class QgsProcessingAlgorithmWidgetBase;
43class QgsProcessingScriptEditorDialog;
44class QMainWindow;
45
55{
56 public:
58
62 virtual QgsProcessingAlgorithmWidgetBase *createWidget(
64 bool inPlace = false,
65 QMainWindow *parent = nullptr,
66 QgsProcessingAlgorithmWidgetBase::WidgetFlags flags = QgsProcessingAlgorithmWidgetBase::WidgetFlags(),
68 ) = 0 SIP_TRANSFERBACK;
69
70
74 virtual QgsProcessingScriptEditorDialog *createScriptEditorDialog( const QString &filePath = QString(), QWidget *parent = nullptr ) = 0 SIP_TRANSFERBACK;
75};
76
86{
87 public:
89
94};
95
106{
107 public:
113 ~QgsProcessingGuiRegistry() override;
114
122
130
139
157
166
179
189
203
222 QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context
223 ) SIP_FACTORY;
224
247 const QString &type,
248 QgsProcessingContext &context,
249 const QgsProcessingParameterWidgetContext &widgetContext,
250 const QgsProcessingParameterDefinition *definition = nullptr,
251 const QgsProcessingAlgorithm *algorithm = nullptr
252 ) SIP_FACTORY;
253
263 QgsProcessingModelConfigWidget *createModelConfigWidgetForComponent( QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext ) const
265
280
293
303 void registerProviderToolboxAction( const QString &providerId, QgsProcessingToolboxAction *action SIP_TRANSFER );
304
313 void deregisterProviderToolboxActions( const QString &providerId );
314
321 QList< QgsProcessingToolboxAction * > toolboxActionsForProvider( const QString &providerId ) const;
322
333
342 void deregisterProviderToolboxContextActions( const QString &providerId );
343
352
360 QList< QgsProcessingToolboxContextAction * > toolboxContextActionsForProvider( const QString &providerId ) const;
361
368 QList< QgsProcessingToolboxContextAction * > toolboxContextActions() const;
369
381
391
403
413
414 private:
415#ifdef SIP_RUN
417#endif
418 QList<QgsProcessingAlgorithmConfigurationWidgetFactory *> mAlgorithmConfigurationWidgetFactories;
419 QMap<QString, QgsProcessingParameterWidgetFactoryInterface *> mParameterWidgetFactories;
420
421 QList<QPointer<QgsProcessingModelConfigWidgetFactory>> mModelConfigWidgetFactories;
422 std::unique_ptr< QgsProcessingGuiInternalModelConfigWidgetFactory > mModelConfigWidgetFactory;
423
424 QgsProcessingWidgetContextGenerator *mWidgetContextGenerator = nullptr;
425
426 QMap< QString, QList< QgsProcessingToolboxAction * > > mProviderToolboxActions;
427 QMap< QString, QList< QgsProcessingToolboxContextAction * > > mProviderToolboxContextActions;
428 std::unique_ptr< QgsProcessingDialogFactory > mProcessingDialogFactory;
429 std::unique_ptr< QgsProcessingContextFactory > mContextFactory;
430};
431
432
433#ifndef SIP_RUN
435class GUI_EXPORT QgsProcessingGuiInternalModelConfigWidgetFactory : public QgsProcessingModelConfigWidgetFactory
436{
437 Q_OBJECT
438 public:
439 bool supportsComponent( QgsProcessingModelComponent *component ) const final;
440 QgsProcessingModelConfigWidget *createWidget( QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext ) const final;
441};
443#endif
444#endif // QGSPROCESSINGGUIREGISTRY_H
ProcessingMode
Types of modes which Processing widgets can be created for.
Definition qgis.h:3890
DockableWidgetInitialState
Dockable widget initial states.
Definition qgis.h:7049
@ RestorePreviousState
Restore the previous state of this dock.
Definition qgis.h:7050
A widget wrapper for Processing parameter value widgets.
Abstract base class for widgets which allow users to specify the properties of a Processing parameter...
Interface base class for factories for algorithm configuration widgets.
A configuration widget for processing algorithms allows providing additional configuration options di...
Abstract base class for processing algorithms.
A factory for creating Processing contexts, aware of the GUI components which may influence this.
virtual ~QgsProcessingContextFactory()
virtual QgsProcessingContext * createContext(QgsProcessingFeedback *feedback=nullptr)=0
Creates a new Processing context.
Contains information about the context in which a processing algorithm is executed.
A factory for creating widgets and dialogs for Processing components.
virtual QgsProcessingAlgorithmWidgetBase * createWidget(QgsProcessingAlgorithm *algorithm, bool inPlace=false, QMainWindow *parent=nullptr, QgsProcessingAlgorithmWidgetBase::WidgetFlags flags=QgsProcessingAlgorithmWidgetBase::WidgetFlags(), Qgis::DockableWidgetInitialState initialState=Qgis::DockableWidgetInitialState::RestorePreviousState)=0
Creates a new widget for executing the specified algorithm.
virtual ~QgsProcessingDialogFactory()
virtual QgsProcessingScriptEditorDialog * createScriptEditorDialog(const QString &filePath=QString(), QWidget *parent=nullptr)=0
Creates a new script editor dialog.
Base class for providing feedback from a processing algorithm.
QgsProcessingDialogFactory * dialogFactory()
Returns the application's processing dialog factory, if set.
void addAlgorithmConfigurationWidgetFactory(QgsProcessingAlgorithmConfigurationWidgetFactory *factory)
Add a new configuration widget factory for customized algorithm configuration widgets.
bool addParameterWidgetFactory(QgsProcessingParameterWidgetFactoryInterface *factory)
Adds a parameter widget factory to the registry, allowing widget creation for parameters of the match...
void deregisterProviderToolboxContextActions(const QString &providerId)
Deregisters all toolbox context menu actions for a provider.
QList< QgsProcessingToolboxContextAction * > toolboxContextActions() const
Returns a list of all toolbox context menu actions registered.
void removeAlgorithmConfigurationWidgetFactory(QgsProcessingAlgorithmConfigurationWidgetFactory *factory)
Remove a configuration widget factory for customized algorithm configuration widgets.
void registerProviderToolboxAction(const QString &providerId, QgsProcessingToolboxAction *action)
Registers a toolbox action for a provider.
void registerModelConfigWidgetFactory(QgsProcessingModelConfigWidgetFactory *factory)
Register a new factory class for creating panel widgets that can be shown in the Processing model des...
void unregisterModelConfigWidgetFactory(QgsProcessingModelConfigWidgetFactory *factory)
Unregister a previously registered factory for creating panel widgets that can be shown in the Proces...
QgsProcessingAlgorithmConfigurationWidget * algorithmConfigurationWidget(const QgsProcessingAlgorithm *algorithm) const
Gets the configuration widget for an algorithm.
QList< QgsProcessingToolboxContextAction * > toolboxContextActionsForProvider(const QString &providerId) const
Returns a list of all toolbox context menu actions registered for a provider.
void deregisterProviderToolboxActions(const QString &providerId)
Deregisters all toolbox actions for a provider.
QgsAbstractProcessingParameterWidgetWrapper * createParameterWidgetWrapper(const QgsProcessingParameterDefinition *parameter, Qgis::ProcessingMode type)
Creates a new parameter widget wrapper for the given parameter.
Q_DECL_DEPRECATED void deregisterProviderToolboxContextAction(QgsProcessingToolboxContextAction *action)
Deregisters a context menu action.
void registerWidgetContextGenerator(QgsProcessingWidgetContextGenerator *generator)
Register a Processing widget context generator class that will be used to retrieve a widget context w...
void setDialogFactory(QgsProcessingDialogFactory *factory)
Sets the application's processing dialog factory.
QgsProcessingAbstractParameterDefinitionWidget * createParameterDefinitionWidget(const QString &type, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext, const QgsProcessingParameterDefinition *definition=nullptr, const QgsProcessingAlgorithm *algorithm=nullptr)
Creates a new parameter definition widget allowing for configuration of an instance of a specific par...
QgsProcessingModelerParameterWidget * createModelerParameterWidget(QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context)
Creates a new modeler parameter widget for the given parameter.
void setContextFactory(QgsProcessingContextFactory *factory)
Sets the application's Processing context factory.
void removeParameterWidgetFactory(QgsProcessingParameterWidgetFactoryInterface *factory)
Removes a parameter widget factory from the registry.
void registerProviderToolboxContextAction(const QString &providerId, QgsProcessingToolboxContextAction *action)
Registers a toolbox context menu action for a provider.
QgsProcessingContextFactory * contextFactory()
Returns the application's Processing context factory, if set.
QgsProcessingModelConfigWidget * createModelConfigWidgetForComponent(QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext) const
Creates a new widget for configuring a Processing model component.
QgsProcessingParameterWidgetContext createWidgetContext() override
Register a Processing widget context.
QList< QgsProcessingToolboxAction * > toolboxActionsForProvider(const QString &providerId) const
Returns a list of all toolbox actions registered for a provider.
Factory class for creating panel widgets that can be shown in the Processing model designer dialog.
A panel widget that can be shown in the Processing model designer dialog for configuring part of the ...
A widget for customising the value of Processing algorithm parameters inside a Processing model.
Base class for the definition of processing parameters.
Contains settings which reflect the context in which a Processing parameter widget is shown.
An interface for Processing widget wrapper factories.
A custom action to show in the Processing toolbox.
A custom action to show in the context menu for the Processing toolbox.
An interface for objects which can create Processing widget contexts.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into allowing algorithms to be written in pure substantial changes are required in order to port existing x Processing algorithms for QGIS x The most significant changes are outlined not GeoAlgorithm For algorithms which operate on features one by consider subclassing the QgsProcessingFeatureBasedAlgorithm class This class allows much of the boilerplate code for looping over features from a vector layer to be bypassed and instead requires implementation of a processFeature method Ensure that your algorithm(or algorithm 's parent class) implements the new pure virtual createInstance(self) call
#define SIP_DEPRECATED
Definition qgis_sip.h:113
#define SIP_TRANSFER
Definition qgis_sip.h:35
#define SIP_TRANSFERBACK
Definition qgis_sip.h:47
#define SIP_FACTORY
Definition qgis_sip.h:83