QGIS API Documentation 3.99.0-Master (a8f284845db)
Loading...
Searching...
No Matches
qgsfilebaseddataitemprovider.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsfilebaseddataitemprovider.h
3 --------------------------------------
4 Date : July 2021
5 Copyright : (C) 2021 by Nyall Dawson
6 Email : nyall dot dawson 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
16#ifndef QGSFILEBASEDDATAITEMPROVIDER_H
17#define QGSFILEBASEDDATAITEMPROVIDER_H
18
19#include "qgis_core.h"
20#include "qgis_sip.h"
23#include "qgsdataitemprovider.h"
24#include "qgslayeritem.h"
26
27#include <QString>
28#include <QVector>
29
30#define SIP_NO_FILE
31
33
34
35class QgsDataItem;
36
47class CORE_EXPORT QgsProviderSublayerItem final: public QgsLayerItem
48{
49 Q_OBJECT
50 public:
51
59 QgsProviderSublayerItem( QgsDataItem *parent, const QString &name, const QgsProviderSublayerDetails &details, const QString &filePath );
60 QString layerName() const override;
61 QVector<QgsDataItem *> createChildren() override;
63
70
71 private:
72
73 static Qgis::BrowserLayerType layerTypeFromSublayer( const QgsProviderSublayerDetails &sublayer );
74
76
77};
78
79
87{
88 Q_OBJECT
89 public:
90
97 QgsFileDataCollectionGroupItem( QgsDataItem *parent, const QString &groupName, const QString &path );
98
102 void appendSublayer( const QgsProviderSublayerDetails &sublayer );
103
104 bool hasDragEnabled() const override;
105 QgsMimeDataUtils::UriList mimeUris() const override;
106
107 private:
108
109 QList< QgsProviderSublayerDetails > mSublayers;
110};
111
122{
123 Q_OBJECT
124 public:
125
137 const QString &name,
138 const QString &path,
139 const QList< QgsProviderSublayerDetails> &sublayers,
140 const QVariantMap &extraUriParts = QVariantMap() );
141
142 QVector<QgsDataItem *> createChildren() override;
143 bool hasDragEnabled() const override;
144
160 bool canAddVectorLayers() const;
161
162 QgsMimeDataUtils::UriList mimeUris() const override;
164
172
180
185 QList<QgsProviderSublayerDetails> sublayers() const;
186
187 private:
188
189 QList< QgsProviderSublayerDetails> mSublayers;
190 QVariantMap mExtraUriParts;
191 mutable bool mHasCachedCapabilities = false;
192 mutable QgsAbstractDatabaseProviderConnection::Capabilities mCachedCapabilities;
193 mutable Qgis::DatabaseProviderConnectionCapabilities2 mCachedCapabilities2;
194 mutable bool mHasCachedDropSupport = false;
195 mutable bool mCachedSupportsDrop = false;
196};
197
198
209{
210 public:
211
212 QString name() override;
214 QgsDataItem *createDataItem( const QString &path, QgsDataItem *parentItem ) override SIP_FACTORY;
215
229 static QgsDataItem *createLayerItemForPath( const QString &path, QgsDataItem *parentItem, const QStringList &providers,
230 const QVariantMap &extraUriParts,
231 Qgis::SublayerQueryFlags queryFlags );
232
233 bool handlesDirectoryPath( const QString &path ) override;
234
235 private:
236
237 static QgsDataItem *createDataItemForPathPrivate( const QString &path, QgsDataItem *parentItem, const QStringList *allowedProviders,
238 Qgis::SublayerQueryFlags queryFlags,
239 const QVariantMap &extraUriParts );
240};
241
242#endif // QGSFILEBASEDDATAITEMPROVIDER_H
QFlags< DataItemProviderCapability > DataItemProviderCapabilities
Capabilities for data item providers.
Definition qgis.h:1013
BrowserLayerType
Browser item layer types.
Definition qgis.h:1022
QFlags< SublayerQueryFlag > SublayerQueryFlags
Sublayer query flags.
Definition qgis.h:1472
QFlags< DatabaseProviderConnectionCapability2 > DatabaseProviderConnectionCapabilities2
Definition qgis.h:5714
Provides common functionality for database based connections.
QgsDataCollectionItem(QgsDataItem *parent, const QString &name, const QString &path=QString(), const QString &providerKey=QString())
Constructor for QgsDataCollectionItem, with the specified parent item.
Interface for providers that add custom data items to the browser tree.
Base class for all items in the model.
Definition qgsdataitem.h:50
QgsDataItem(Qgis::BrowserItemType type, QgsDataItem *parent, const QString &name, const QString &path, const QString &providerKey=QString())
Constructor for QgsDataItem, with the specified parent item.
virtual QVector< QgsDataItem * > createChildren()
Create children.
QString name() const
Returns the name of the item (the displayed text for the item).
QString path() const
QgsDataItem * parent() const
Gets item parent.
A data item provider for file based data sources.
static QgsDataItem * createLayerItemForPath(const QString &path, QgsDataItem *parentItem, const QStringList &providers, const QVariantMap &extraUriParts, Qgis::SublayerQueryFlags queryFlags)
Static method to create a data item for sublayers corresponding to a file-like path.
Qgis::DataItemProviderCapabilities capabilities() const override
Returns combination of flags from QgsDataProvider::DataCapabilities.
bool handlesDirectoryPath(const QString &path) override
Returns true if the provider will handle the directory at the specified path.
QgsDataItem * createDataItem(const QString &path, QgsDataItem *parentItem) override
Create a new instance of QgsDataItem (or nullptr) for given path and parent item.
QgsFileDataCollectionGroupItem(QgsDataItem *parent, const QString &groupName, const QString &path)
Constructor for QgsFileDataCollectionGroupItem.
void appendSublayer(const QgsProviderSublayerDetails &sublayer)
Adds a sublayer to the group.
QgsAbstractDatabaseProviderConnection::Capabilities databaseConnectionCapabilities() const
Returns the associated connection capabilities, if a databaseConnection() is available.
QgsFileDataCollectionItem(QgsDataItem *parent, const QString &name, const QString &path, const QList< QgsProviderSublayerDetails > &sublayers, const QVariantMap &extraUriParts=QVariantMap())
Constructor for QgsFileDataCollectionItem.
QList< QgsProviderSublayerDetails > sublayers() const
Returns the sublayers.
bool canAddVectorLayers() const
Returns true if the file is likely to support addition of vector layers.
Qgis::DatabaseProviderConnectionCapabilities2 databaseConnectionCapabilities2() const
Returns extended connection capabilities, if a databaseConnection() is available.
QgsAbstractDatabaseProviderConnection * databaseConnection() const override
For data items that represent a DB connection or one of its children, this method returns a connectio...
QgsLayerItem(QgsDataItem *parent, const QString &name, const QString &path, const QString &uri, Qgis::BrowserLayerType layerType, const QString &providerKey)
Constructor for QgsLayerItem.
bool hasDragEnabled() const override
Returns true if the item may be dragged.
QgsMimeDataUtils::UriList mimeUris() const override
Returns mime URIs for the data item, most data providers will only return a single URI but some data ...
virtual QString layerName() const
Returns the layer name.
QList< QgsMimeDataUtils::Uri > UriList
Contains details about a sub layer available from a dataset.
QgsProviderSublayerItem(QgsDataItem *parent, const QString &name, const QgsProviderSublayerDetails &details, const QString &filePath)
Constructor for QgsProviderSublayerItem.
QgsProviderSublayerDetails sublayerDetails() const
Returns the sublayer details for the item.
#define SIP_FACTORY
Definition qgis_sip.h:83