QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsalgorithmloadlayer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmloadlayer.cpp
3 ---------------------
4 begin : November 2017
5 copyright : (C) 2017 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
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
19
21
22QString QgsLoadLayerAlgorithm::name() const
23{
24 return QStringLiteral( "loadlayer" );
25}
26
27Qgis::ProcessingAlgorithmFlags QgsLoadLayerAlgorithm::flags() const
28{
30}
31
32QString QgsLoadLayerAlgorithm::displayName() const
33{
34 return QObject::tr( "Load layer into project" );
35}
36
37QStringList QgsLoadLayerAlgorithm::tags() const
38{
39 return QObject::tr( "load,open,layer,raster,vector,project" ).split( ',' );
40}
41
42QString QgsLoadLayerAlgorithm::group() const
43{
44 return QObject::tr( "Modeler tools" );
45}
46
47QString QgsLoadLayerAlgorithm::groupId() const
48{
49 return QStringLiteral( "modelertools" );
50}
51
52QString QgsLoadLayerAlgorithm::shortHelpString() const
53{
54 return QObject::tr( "This algorithm loads a layer to the current project." );
55}
56
57QgsLoadLayerAlgorithm *QgsLoadLayerAlgorithm::createInstance() const
58{
59 return new QgsLoadLayerAlgorithm();
60}
61
62void QgsLoadLayerAlgorithm::initAlgorithm( const QVariantMap & )
63{
64 addParameter( new QgsProcessingParameterMapLayer( QStringLiteral( "INPUT" ), QObject::tr( "Layer" ) ) );
65 addParameter( new QgsProcessingParameterString( QStringLiteral( "NAME" ), QObject::tr( "Loaded layer name" ) ) );
66 addOutput( new QgsProcessingOutputMapLayer( QStringLiteral( "OUTPUT" ), QObject::tr( "Layer" ) ) );
67}
68
69QVariantMap QgsLoadLayerAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
70{
71 QgsMapLayer *layer = parameterAsLayer( parameters, QStringLiteral( "INPUT" ), context );
72 const QString name = parameterAsString( parameters, QStringLiteral( "NAME" ), context );
73
74 if ( !layer )
75 throw QgsProcessingException( QObject::tr( "Invalid input layer" ) );
76
77 if ( name.isEmpty() )
78 throw QgsProcessingException( QObject::tr( "Invalid (empty) layer name" ) );
79
80 layer->setName( name );
81 QgsProcessingContext::LayerDetails details( name, context.project(), name );
82 details.forceName = true;
83 context.addLayerToLoadOnCompletion( layer->id(), details );
84
85 QVariantMap results;
86 results.insert( QStringLiteral( "OUTPUT" ), layer->id() );
87 return results;
88}
89
QFlags< ProcessingAlgorithmFlag > ProcessingAlgorithmFlags
Flags indicating how and when an algorithm operates and should be exposed to users.
Definition: qgis.h:2934
@ NotAvailableInStandaloneTool
Algorithm should not be available from the standalone "qgis_process" tool. Used to flag algorithms wh...
@ HideFromToolbox
Algorithm should be hidden from the toolbox.
Base class for all map layer types.
Definition: qgsmaplayer.h:75
QString id() const
Returns the layer's unique ID, which is used to access this layer from QgsProject.
void setName(const QString &name)
Set the display name of the layer.
Details for layers to load into projects.
Contains information about the context in which a processing algorithm is executed.
void addLayerToLoadOnCompletion(const QString &layer, const QgsProcessingContext::LayerDetails &details)
Adds a layer to load (by ID or datasource) into the canvas upon completion of the algorithm or model.
QgsProject * project() const
Returns the project in which the algorithm is being executed.
Custom exception class for processing related exceptions.
Definition: qgsexception.h:83
Base class for providing feedback from a processing algorithm.
A map layer output for processing algorithms, where layers may be either vector or raster.
A map layer parameter for processing algorithms.
A string parameter for processing algorithms.