Class: QgsProcessingParameterFileDestination

class qgis.core.QgsProcessingParameterFileDestination

Bases: QgsProcessingDestinationParameter

A generic file based destination parameter, for specifying the destination path for a file (non-map layer) created by the algorithm.

In some circumstances it is desirable to avoid the usual file overwriting confirmation prompt when users select an existing destination file for this parameter type (e.g., for algorithms which append to an existing destination file instead of overwriting them.). This can be done by setting the widget wrapper metadata “dontconfirmoverwrite” option:

param = QgsProcessingParameterFileDestination( 'OUTPUT', 'Destination file')
# don't show the file overwrite warning when users select a destination file:
param.setMetadata( {'widget_wrapper':
  { 'dontconfirmoverwrite': True }
})

New in version 3.0.

QgsProcessingParameterFileDestination(name: str, description: str = ‘’, fileFilter: str = ‘’, defaultValue: Any = None, optional: bool = False, createByDefault: bool = True) Constructor for QgsProcessingParameterFileDestination.

If createByDefault is False and the parameter is optional, then this destination output will not be created by default.

QgsProcessingParameterFileDestination(QgsProcessingParameterFileDestination)

Methods

asPythonString

param outputType:

checkValueIsAcceptable

param input:

clone

rtype:

QgsProcessingParameterDefinition

createFileFilter

rtype:

str

defaultFileExtension

rtype:

str

fileFilter

Returns the file filter string for file destinations compatible with this parameter.

fromScriptCode

Creates a new parameter using the definition from a script code.

fromVariantMap

param map:

originalProvider

Original (source) provider which this parameter has been derived from.

setFileFilter

Sets the file filter string for file destinations compatible with this parameter.

toOutputDefinition

rtype:

QgsProcessingOutputDefinition

toVariantMap

rtype:

Dict[str, Any]

type

rtype:

str

typeName

Returns the type name for the parameter class.

valueAsPythonString

param value:

asPythonString(self, outputType: QgsProcessing.PythonOutputType = QgsProcessing.PythonQgsProcessingAlgorithmSubclass) str
Parameters:

outputType (QgsProcessing.PythonOutputType = QgsProcessing.PythonQgsProcessingAlgorithmSubclass) –

Return type:

str

checkValueIsAcceptable(self, input: Any, context: QgsProcessingContext = None) bool
Parameters:
Return type:

bool

clone(self) QgsProcessingParameterDefinition
Return type:

QgsProcessingParameterDefinition

createFileFilter(self) str
Return type:

str

defaultFileExtension(self) str
Return type:

str

fileFilter(self) str

Returns the file filter string for file destinations compatible with this parameter.

See also

setFileFilter()

Return type:

str

fromScriptCode(name: str, description: str, isOptional: bool, definition: str) QgsProcessingParameterFileDestination

Creates a new parameter using the definition from a script code.

Parameters:
  • name (str) –

  • description (str) –

  • isOptional (bool) –

  • definition (str) –

Return type:

QgsProcessingParameterFileDestination

fromVariantMap(self, map: Dict[str, Any]) bool
Parameters:

map (Dict[str) –

Return type:

bool

originalProvider(self) QgsProcessingProvider

Original (source) provider which this parameter has been derived from. In the case of destination parameters which are part of model algorithms, this will reflect the child algorithm’s provider which actually generates the parameter, as opposed to the provider which this parameter belongs to (i.e. the model provider)

New in version 3.2.

setFileFilter(self, filter: str)

Sets the file filter string for file destinations compatible with this parameter.

See also

fileFilter()

Parameters:

filter (str) –

toOutputDefinition(self) QgsProcessingOutputDefinition
Return type:

QgsProcessingOutputDefinition

toVariantMap(self) Dict[str, Any]
Return type:

Dict[str, Any]

type(self) str
Return type:

str

typeName() str

Returns the type name for the parameter class.

Return type:

str

valueAsPythonString(self, value: Any, context: QgsProcessingContext) str
Parameters:
Return type:

str