Base class for the definition of processing outputs. More...

#include <qgsprocessingoutputs.h>

Inheritance diagram for QgsProcessingOutputDefinition:

[legend]

Public Member Functions
	QgsProcessingOutputDefinition (const QString &name, const QString &description=QString())
	Constructor for QgsProcessingOutputDefinition.
virtual	~QgsProcessingOutputDefinition ()=default
bool	autoCreated () const
	Returns `true` if the output was automatically created when adding a parameter.
QString	description () const
	Returns the description for the output.
virtual QColor	modelColor () const
	Returns the color to use for the output in the model designer canvas.
QString	name () const
	Returns the name of the output.
void	setAutoCreated (bool autoCreated)
	Sets whether an output was automatically created when adding a parameter.
void	setDescription (const QString &description)
	Sets the description for the output.
void	setName (const QString &name)
	Sets the name of the output.
virtual QString	type () const =0
	Unique output type name.
virtual QString	valueAsFormattedString (const QVariant &value, QgsProcessingContext &context, bool &ok) const
	Returns a HTML string version of the parameter output value (if possible).
virtual QString	valueAsString (const QVariant &value, QgsProcessingContext &context, bool &ok) const
	Returns a string version of the parameter output value (if possible).

Protected Attributes
bool	mAutoCreated = false
QString	mDescription
	Output description.
QString	mName
	Output name.

Detailed Description

Base class for the definition of processing outputs.

Output definitions encapsulate the properties regarding the outputs from algorithms, such as generated layers or calculated values.

Definition at line 43 of file qgsprocessingoutputs.h.

Constructor & Destructor Documentation

◆ QgsProcessingOutputDefinition()

QgsProcessingOutputDefinition::QgsProcessingOutputDefinition	(	const QString &	name,
		const QString &	description = QString() )

Constructor for QgsProcessingOutputDefinition.

Definition at line 25 of file qgsprocessingoutputs.cpp.

◆ ~QgsProcessingOutputDefinition()

virtual QgsProcessingOutputDefinition::~QgsProcessingOutputDefinition ( )

virtualdefault

Member Function Documentation

◆ autoCreated()

bool QgsProcessingOutputDefinition::autoCreated ( ) const

inline

Returns true if the output was automatically created when adding a parameter.

See also: setAutoCreated()

Since: QGIS 3.14

Definition at line 143 of file qgsprocessingoutputs.h.

◆ description()

QString QgsProcessingOutputDefinition::description ( ) const

inline

Returns the description for the output.

This is the user-visible string used to identify this output.

See also: setDescription()

Definition at line 121 of file qgsprocessingoutputs.h.

◆ modelColor()

QColor QgsProcessingOutputDefinition::modelColor ( ) const

virtual

Returns the color to use for the output in the model designer canvas.

Since: QGIS 4.0

Reimplemented in QgsProcessingOutputBoolean, QgsProcessingOutputFile, QgsProcessingOutputFolder, QgsProcessingOutputHtml, QgsProcessingOutputMapLayer, QgsProcessingOutputMultipleLayers, QgsProcessingOutputNumber, QgsProcessingOutputRasterLayer, QgsProcessingOutputString, QgsProcessingOutputVectorLayer, and QgsProcessingOutputVectorTileLayer.

Definition at line 52 of file qgsprocessingoutputs.cpp.

◆ name()

QString QgsProcessingOutputDefinition::name ( ) const

inline

Returns the name of the output.

This is the internal identifier by which algorithms access this output.

See also: setName()

Definition at line 107 of file qgsprocessingoutputs.h.

◆ setAutoCreated()

void QgsProcessingOutputDefinition::setAutoCreated ( bool autoCreated )

inline

Sets whether an output was automatically created when adding a parameter.

Parameters

autoCreated set to true if the output is to be considered as automatically created.

See also: autoCreated()

Since: QGIS 3.14

Definition at line 136 of file qgsprocessingoutputs.h.

◆ setDescription()

void QgsProcessingOutputDefinition::setDescription ( const QString & description )

inline

Sets the description for the output.

This is the user-visible string used to identify this output.

See also: description()

Definition at line 128 of file qgsprocessingoutputs.h.

◆ setName()

void QgsProcessingOutputDefinition::setName ( const QString & name )

inline

Sets the name of the output.

This is the internal identifier by which algorithms access this output.

See also: name()

Definition at line 114 of file qgsprocessingoutputs.h.

◆ type()

virtual QString QgsProcessingOutputDefinition::type ( ) const

pure virtual

Unique output type name.

Implemented in QgsProcessingOutputBoolean, QgsProcessingOutputConditionalBranch, QgsProcessingOutputFile, QgsProcessingOutputFolder, QgsProcessingOutputHtml, QgsProcessingOutputMapLayer, QgsProcessingOutputMultipleLayers, QgsProcessingOutputNumber, QgsProcessingOutputPointCloudLayer, QgsProcessingOutputRasterLayer, QgsProcessingOutputString, QgsProcessingOutputVariant, QgsProcessingOutputVectorLayer, and QgsProcessingOutputVectorTileLayer.

◆ valueAsFormattedString()

QString QgsProcessingOutputDefinition::valueAsFormattedString	(	const QVariant &	value,
		QgsProcessingContext &	context,
		bool &	ok ) const

virtual

Returns a HTML string version of the parameter output value (if possible).

By default this will return the same value as valueAsString().

Parameters

value	value to convert
context	processing context
ok	will be set to `true` if value could be represented as a string.

Returns: value converted to string

See also: valueAsString()

Since: QGIS 3.36

Reimplemented in QgsProcessingOutputFile, QgsProcessingOutputFolder, and QgsProcessingOutputHtml.

Definition at line 47 of file qgsprocessingoutputs.cpp.

◆ valueAsString()

QString QgsProcessingOutputDefinition::valueAsString	(	const QVariant &	value,
		QgsProcessingContext &	context,
		bool &	ok ) const

virtual

Returns a string version of the parameter output value (if possible).

Parameters

value	value to convert
context	processing context
ok	will be set to `true` if value could be represented as a string.

Returns: value converted to string

See also: valueAsFormattedString()

Since: QGIS 3.36

Reimplemented in QgsProcessingOutputBoolean, QgsProcessingOutputMultipleLayers, QgsProcessingOutputNumber, and QgsProcessingOutputVariant.

Definition at line 30 of file qgsprocessingoutputs.cpp.

Member Data Documentation

◆ mAutoCreated

bool QgsProcessingOutputDefinition::mAutoCreated = false

protected

Definition at line 183 of file qgsprocessingoutputs.h.

◆ mDescription

QString QgsProcessingOutputDefinition::mDescription

protected

Output description.

Definition at line 181 of file qgsprocessingoutputs.h.

◆ mName

QString QgsProcessingOutputDefinition::mName

protected

Output name.

Definition at line 178 of file qgsprocessingoutputs.h.

The documentation for this class was generated from the following files:

/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/core/processing/qgsprocessingoutputs.h
/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/core/processing/qgsprocessingoutputs.cpp

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ QgsProcessingOutputDefinition()

◆ ~QgsProcessingOutputDefinition()

Member Function Documentation

◆ autoCreated()

◆ description()

◆ modelColor()

◆ name()

◆ setAutoCreated()

◆ setDescription()

◆ setName()

◆ type()

◆ valueAsFormattedString()

◆ valueAsString()

Member Data Documentation

◆ mAutoCreated

◆ mDescription

◆ mName