Class: QgsProcessingGuiRegistry

class qgis.gui.QgsProcessingGuiRegistry

Bases: sip.wrapper

Constructor. Should never be called manually, is already created by QgsGui.

QgsProcessingGuiRegistry(QgsProcessingGuiRegistry)

The QgsProcessingGuiRegistry is a home for widgets for processing configuration widgets.

QgsProcessingGuiRegistry is not usually directly created, but rather accessed through QgsGui.processingGuiRegistry()

Methods

addAlgorithmConfigurationWidgetFactory

Add a new configuration widget factory for customized algorithm configuration widgets.

addParameterWidgetFactory

Adds a parameter widget factory to the registry, allowing widget creation for parameters of the matching type via createParameterWidgetWrapper() and createModelerParameterWidget().

algorithmConfigurationWidget

Gets the configuration widget for an algorithm.

createModelerParameterWidget

Creates a new modeler parameter widget for the given parameter.

createParameterWidgetWrapper

Creates a new parameter widget wrapper for the given parameter.

removeAlgorithmConfigurationWidgetFactory

Remove a configuration widget factory for customized algorithm configuration widgets.

removeParameterWidgetFactory

Removes a parameter widget factory from the registry.

addAlgorithmConfigurationWidgetFactory(self, factory: QgsProcessingAlgorithmConfigurationWidgetFactory)

Add a new configuration widget factory for customized algorithm configuration widgets. Ownership is taken.

New in version 3.2.

Parameters

factory (QgsProcessingAlgorithmConfigurationWidgetFactory) –

addParameterWidgetFactory(self, factory: QgsProcessingParameterWidgetFactoryInterface) → bool

Adds a parameter widget factory to the registry, allowing widget creation for parameters of the matching type via createParameterWidgetWrapper() and createModelerParameterWidget().

Ownership of factory is transferred to the registry.

Returns true if the factory was successfully added, or false if the factory could not be added. Each factory must return a unique value for QgsProcessingParameterWidgetFactoryInterface.parameterType(), and attempting to add a new factory with a duplicate type will result in failure.

New in version 3.4.

Parameters

factory (QgsProcessingParameterWidgetFactoryInterface) –

Return type

bool

algorithmConfigurationWidget(self, algorithm: QgsProcessingAlgorithm) → QgsProcessingAlgorithmConfigurationWidget

Gets the configuration widget for an algorithm. This widget will be shown next to parameter widgets. Most algorithms do not have a configuration widget and in this case, None will be returned.

New in version 3.2.

Parameters

algorithm (QgsProcessingAlgorithm) –

Return type

QgsProcessingAlgorithmConfigurationWidget

createModelerParameterWidget(self, model: QgsProcessingModelAlgorithm, childId: str, parameter: QgsProcessingParameterDefinition, context: QgsProcessingContext) → QgsProcessingModelerParameterWidget

Creates a new modeler parameter widget for the given parameter. This widget allows configuration of the parameter’s value when used inside a Processing model.

The ID of the child algorithm within the model must be specified via the childId argument. This value corresponds to the QgsProcessingModelChildAlgorithm.childId() string, which uniquely identifies which child algorithm the parameter is associated with inside the given model.

The caller takes ownership of the returned widget. If no factory is registered which handles the given parameter, a None will be returned.

New in version 3.4.

Parameters
Return type

QgsProcessingModelerParameterWidget

createParameterWidgetWrapper(self, parameter: QgsProcessingParameterDefinition, type: QgsProcessingGui.WidgetType) → QgsAbstractProcessingParameterWidgetWrapper

Creates a new parameter widget wrapper for the given parameter. The type argument dictates the type of dialog the wrapper should be created for. The caller takes ownership of the returned wrapper.

If no factory is registered which handles the given parameter, a None will be returned.

New in version 3.4.

Parameters
Return type

QgsAbstractProcessingParameterWidgetWrapper

removeAlgorithmConfigurationWidgetFactory(self, factory: QgsProcessingAlgorithmConfigurationWidgetFactory)

Remove a configuration widget factory for customized algorithm configuration widgets.

New in version 3.2.

Parameters

factory (QgsProcessingAlgorithmConfigurationWidgetFactory) –

removeParameterWidgetFactory(self, factory: QgsProcessingParameterWidgetFactoryInterface)

Removes a parameter widget factory from the registry. The factory will be deleted.

New in version 3.4.

Parameters

factory (QgsProcessingParameterWidgetFactoryInterface) –