QGIS API Documentation  3.24.2-Tisler (13c1a02865)
qgsmimedatautils.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsmimedatautils.h
3  ---------------------
4  begin : November 2011
5  copyright : (C) 2011 by Martin Dobias
6  email : wonder dot sk at gmail dot com
7  ***************************************************************************
8  * *
9  * This program is free software; you can redistribute it and/or modify *
10  * it under the terms of the GNU General Public License as published by *
11  * the Free Software Foundation; either version 2 of the License, or *
12  * (at your option) any later version. *
13  * *
14  ***************************************************************************/
15 #ifndef QGSMIMEDATAUTILS_H
16 #define QGSMIMEDATAUTILS_H
17 
18 #include <QMimeData>
19 #include <QStringList>
20 
21 #include "qgis_core.h"
22 #include "qgis_sip.h"
23 #include "qgswkbtypes.h"
24 
25 class QgsLayerItem;
26 class QgsLayerTreeNode;
27 class QgsVectorLayer;
28 class QgsRasterLayer;
29 class QgsMeshLayer;
30 class QgsMapLayer;
31 
36 class CORE_EXPORT QgsMimeDataUtils
37 {
38  public:
39 
40  struct CORE_EXPORT Uri
41  {
43  Uri() = default;
45  explicit Uri( const QString &encData );
46 
52  explicit Uri( QgsMapLayer *layer );
53 
58  bool isValid() const { return !layerType.isEmpty(); }
59 
61  QString data() const;
62 
68  QgsVectorLayer *vectorLayer( bool &owner, QString &error ) const;
69 
75  QgsRasterLayer *rasterLayer( bool &owner, QString &error ) const;
76 
82  QgsMeshLayer *meshLayer( bool &owner, QString &error ) const;
83 
93  QgsMapLayer *mapLayer() const;
94 
112  QString layerType;
113 
120  QString providerKey;
121 
123  QString name;
125  QString uri;
126  QStringList supportedCrs;
127  QStringList supportedFormats;
128 
133  QString layerId;
134 
140  QString pId;
141 
149 
154  QString filePath;
155 
156 #ifdef SIP_RUN
157  SIP_PYOBJECT __repr__();
158  % MethodCode
159  QString str = QStringLiteral( "<QgsMimeDataUtils::Uri (%1): %2>" ).arg( sipCpp->providerKey, sipCpp->uri );
160  sipRes = PyUnicode_FromString( str.toUtf8().constData() );
161  % End
162 #endif
163  };
164  typedef QList<QgsMimeDataUtils::Uri> UriList;
165 
169  static QMimeData *encodeUriList( const UriList &layers ) SIP_FACTORY;
170 
171  static bool isUriList( const QMimeData *data );
172 
173  static UriList decodeUriList( const QMimeData *data );
174 
179  static QByteArray layerTreeNodesToUriList( const QList<QgsLayerTreeNode *> &nodes );
180 
187  static bool hasOriginatedFromCurrentAppInstance( const QgsMimeDataUtils::Uri &uri );
188 
189  private:
190  static QString encode( const QStringList &items );
191  static QStringList decode( const QString &encoded );
192  static QByteArray uriListToByteArray( const UriList &layers );
193 
194 
195  friend class TestQgsMimeDataUtils;
196 
197 };
198 
200 
201 #endif // QGSMIMEDATAUTILS_H
202 
Item that represents a layer that can be opened with one of the providers.
Definition: qgslayeritem.h:30
This class is a base class for nodes in a layer tree.
Base class for all map layer types.
Definition: qgsmaplayer.h:73
Represents a mesh layer supporting display of data on structured or unstructured meshes.
Definition: qgsmeshlayer.h:97
QList< QgsMimeDataUtils::Uri > UriList
Represents a raster layer.
Represents a vector layer which manages a vector based data sets.
Type
The WKB type describes the number of dimensions a geometry has.
Definition: qgswkbtypes.h:70
#define str(x)
Definition: qgis.cpp:37
#define SIP_FACTORY
Definition: qgis_sip.h:76
Q_DECLARE_METATYPE(QgsMeshTimeSettings)
QString filePath
Path to file, if uri is associated with a file.
QString uri
Identifier of the data source recognized by its providerKey.
QString name
Human readable name to be used e.g. in layer tree.
QString pId
Unique ID associated with application instance.
QString providerKey
For "vector" / "raster" type: provider id.
QString layerId
Layer ID, if uri is associated with a layer from a QgsProject.
Uri()=default
Constructs invalid URI.
QString layerType
Type of URI.
bool isValid() const
Returns whether the object contains valid data.