QGIS API Documentation 3.99.0-Master (2fe06baccd8)
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
31
32#define SIP_NO_FILE
33
34class QgsDataItem;
35
46class CORE_EXPORT QgsProviderSublayerItem final: public QgsLayerItem
47{
48 Q_OBJECT
49 public:
50
58 QgsProviderSublayerItem( QgsDataItem *parent, const QString &name, const QgsProviderSublayerDetails &details, const QString &filePath );
59 QString layerName() const override;
60 QVector<QgsDataItem *> createChildren() override;
62
69
70 private:
71
72 static Qgis::BrowserLayerType layerTypeFromSublayer( const QgsProviderSublayerDetails &sublayer );
73
75
76};
77
78
86{
87 Q_OBJECT
88 public:
89
96 QgsFileDataCollectionGroupItem( QgsDataItem *parent, const QString &groupName, const QString &path );
97
101 void appendSublayer( const QgsProviderSublayerDetails &sublayer );
102
103 bool hasDragEnabled() const override;
104 QgsMimeDataUtils::UriList mimeUris() const override;
105
106 private:
107
108 QList< QgsProviderSublayerDetails > mSublayers;
109};
110
121{
122 Q_OBJECT
123 public:
124
136 const QString &name,
137 const QString &path,
138 const QList< QgsProviderSublayerDetails> &sublayers,
139 const QVariantMap &extraUriParts = QVariantMap() );
140
141 QVector<QgsDataItem *> createChildren() override;
142 bool hasDragEnabled() const override;
143
159 bool canAddVectorLayers() const;
160
161 QgsMimeDataUtils::UriList mimeUris() const override;
163
171
179
184 QList<QgsProviderSublayerDetails> sublayers() const;
185
186 private:
187
188 QList< QgsProviderSublayerDetails> mSublayers;
189 QVariantMap mExtraUriParts;
190 mutable bool mHasCachedCapabilities = false;
191 mutable QgsAbstractDatabaseProviderConnection::Capabilities mCachedCapabilities;
192 mutable Qgis::DatabaseProviderConnectionCapabilities2 mCachedCapabilities2;
193 mutable bool mHasCachedDropSupport = false;
194 mutable bool mCachedSupportsDrop = false;
195};
196
197
208{
209 public:
210
211 QString name() override;
213 QgsDataItem *createDataItem( const QString &path, QgsDataItem *parentItem ) override SIP_FACTORY;
214
228 static QgsDataItem *createLayerItemForPath( const QString &path, QgsDataItem *parentItem, const QStringList &providers,
229 const QVariantMap &extraUriParts,
230 Qgis::SublayerQueryFlags queryFlags );
231
232 bool handlesDirectoryPath( const QString &path ) override;
233
234 private:
235
236 static QgsDataItem *createDataItemForPathPrivate( const QString &path, QgsDataItem *parentItem, const QStringList *allowedProviders,
237 Qgis::SublayerQueryFlags queryFlags,
238 const QVariantMap &extraUriParts );
239};
240
241#endif // QGSFILEBASEDDATAITEMPROVIDER_H
QFlags< DataItemProviderCapability > DataItemProviderCapabilities
Capabilities for data item providers.
Definition qgis.h:992
BrowserLayerType
Browser item layer types.
Definition qgis.h:1001
QFlags< SublayerQueryFlag > SublayerQueryFlags
Sublayer query flags.
Definition qgis.h:1399
QFlags< DatabaseProviderConnectionCapability2 > DatabaseProviderConnectionCapabilities2
Definition qgis.h:5398
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:47
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:84