QGIS API Documentation 4.1.0-Master (5bf3c20f3c9)
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:
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 static Qgis::BrowserLayerType layerTypeFromSublayer( const QgsProviderSublayerDetails &sublayer );
72
74};
75
76
84{
85 Q_OBJECT
86 public:
93 QgsFileDataCollectionGroupItem( QgsDataItem *parent, const QString &groupName, const QString &path );
94
98 void appendSublayer( const QgsProviderSublayerDetails &sublayer );
99
100 bool hasDragEnabled() const override;
101 QgsMimeDataUtils::UriList mimeUris() const override;
102
103 private:
104 QList< QgsProviderSublayerDetails > mSublayers;
105};
106
116class CORE_EXPORT QgsFileDataCollectionItem final : public QgsDataCollectionItem
117{
118 Q_OBJECT
119 public:
130 QgsFileDataCollectionItem( QgsDataItem *parent, const QString &name, const QString &path, const QList< QgsProviderSublayerDetails> &sublayers, const QVariantMap &extraUriParts = QVariantMap() );
131
132 QVector<QgsDataItem *> createChildren() override;
133 bool hasDragEnabled() const override;
134
150 bool canAddVectorLayers() const;
151
152 QgsMimeDataUtils::UriList mimeUris() const override;
154
162
170
175 QList<QgsProviderSublayerDetails> sublayers() const;
176
177 private:
178 QList< QgsProviderSublayerDetails> mSublayers;
179 QVariantMap mExtraUriParts;
180 mutable bool mHasCachedCapabilities = false;
181 mutable QgsAbstractDatabaseProviderConnection::Capabilities mCachedCapabilities;
182 mutable Qgis::DatabaseProviderConnectionCapabilities2 mCachedCapabilities2;
183 mutable bool mHasCachedDropSupport = false;
184 mutable bool mCachedSupportsDrop = false;
185};
186
187
198{
199 public:
200 QString name() override;
202 QgsDataItem *createDataItem( const QString &path, QgsDataItem *parentItem ) override SIP_FACTORY;
203
217 static QgsDataItem *createLayerItemForPath( const QString &path, QgsDataItem *parentItem, const QStringList &providers, const QVariantMap &extraUriParts, Qgis::SublayerQueryFlags queryFlags );
218
219 bool handlesDirectoryPath( const QString &path ) override;
220
221 private:
222 static QgsDataItem *createDataItemForPathPrivate(
223 const QString &path, QgsDataItem *parentItem, const QStringList *allowedProviders, Qgis::SublayerQueryFlags queryFlags, const QVariantMap &extraUriParts
224 );
225};
226
227#endif // QGSFILEBASEDDATAITEMPROVIDER_H
QFlags< DataItemProviderCapability > DataItemProviderCapabilities
Capabilities for data item providers.
Definition qgis.h:1018
BrowserLayerType
Browser item layer types.
Definition qgis.h:1027
QFlags< SublayerQueryFlag > SublayerQueryFlags
Sublayer query flags.
Definition qgis.h:1477
QFlags< DatabaseProviderConnectionCapability2 > DatabaseProviderConnectionCapabilities2
Definition qgis.h:5754
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