QGIS API Documentation
3.0.2-Girona (307d082)
|
A registry / canonical manager of data providers. More...
#include <qgsproviderregistry.h>
Public Types | |
typedef std::map< QString, QgsProviderMetadata * > | Providers |
Open the given vector data source. More... | |
enum | WidgetMode { None, Embedded, Manager } |
Different ways a source select dialog can be used (embedded is for the data source manager dialog) More... | |
Public Member Functions | |
virtual | ~QgsProviderRegistry () |
QgsDataProvider * | createProvider (const QString &providerKey, const QString &dataSource) |
Creates a new instance of a provider. More... | |
QLibrary * | createProviderLibrary (const QString &providerKey) const |
Returns a new QLibrary for the specified providerKey. More... | |
QWidget * | createSelectionWidget (const QString &providerKey, QWidget *parent=nullptr, Qt::WindowFlags fl=Qt::WindowFlags(), QgsProviderRegistry::WidgetMode widgetMode=QgsProviderRegistry::WidgetMode::None) |
Returns a new widget for selecting layers from a provider. More... | |
virtual QString | databaseDrivers () const |
Return a string containing the available database drivers. More... | |
virtual QString | directoryDrivers () const |
Return a string containing the available directory drivers. More... | |
virtual QString | fileRasterFilters () const |
Return raster file filter string. More... | |
virtual QString | fileVectorFilters () const |
Return vector file filter string. More... | |
QFunctionPointer | function (const QString &providerKey, const QString &functionName) |
Get pointer to provider function. More... | |
QString | library (const QString &providerKey) const |
Return path for the library of the provider. More... | |
QDir | libraryDirectory () const |
Returns the library directory where plugins are found. More... | |
QString | pluginList (bool asHtml=false) const |
Return list of provider plugins found. More... | |
virtual QString | protocolDrivers () const |
Return a string containing the available protocol drivers. More... | |
int | providerCapabilities (const QString &providerKey) const |
Return the provider capabilities. More... | |
QStringList | providerList () const |
Return list of available providers by their keys. More... | |
const QgsProviderMetadata * | providerMetadata (const QString &providerKey) const |
Return metadata of the provider or NULL if not found. More... | |
void | registerGuis (QWidget *widget) |
void | setLibraryDirectory (const QDir &path) |
Set library directory where to search for plugins. More... | |
Static Public Member Functions | |
static QgsProviderRegistry * | instance (const QString &pluginPath=QString()) |
Means of accessing canonical single instance. More... | |
A registry / canonical manager of data providers.
This is a Singleton class that manages data provider access.
Providers can be either loaded via libraries or native providers that are included in the core QGIS installation and accessed through function pointers.
Loaded providers may be restricted using QGIS_PROVIDER_FILE environment variable. QGIS_PROVIDER_FILE is regexp pattern applied to provider file name (not provider key). For example, if the variable is set to gdal|ogr|postgres it will load only providers gdal, ogr and postgres.
Definition at line 52 of file qgsproviderregistry.h.
typedef std::map<QString, QgsProviderMetadata *> QgsProviderRegistry::Providers |
Open the given vector data source.
Similar to open(QString const &), except that the user specifies a data provider with which to open the data source instead of using the default data provider that QgsDataManager would figure out to use. This should be useful when (and if) there will exist more than one data provider that can handle a given data source. (E.g., use GDAL to open an SDTS file, or a different data provider that uses sdts++.)
Called by QgsDataManager::open().
name | could be a file, URI |
provider | is the key for the dataprovider used to open name |
Temporarily always returns false until finished implementing.
Eventually would be nice if could make QgsDataManager smart enough to figure out whether the given name mapped to a vector, raster, or database source.Type for data provider metadata associative container
Definition at line 204 of file qgsproviderregistry.h.
Different ways a source select dialog can be used (embedded is for the data source manager dialog)
Enumerator | |
---|---|
None | |
Embedded | |
Manager |
Definition at line 61 of file qgsproviderregistry.h.
|
virtual |
Definition at line 264 of file qgsproviderregistry.cpp.
QgsDataProvider * QgsProviderRegistry::createProvider | ( | const QString & | providerKey, |
const QString & | dataSource | ||
) |
Creates a new instance of a provider.
providerKey | identificator of the provider |
dataSource | string containing data source for the provider |
Definition at line 368 of file qgsproviderregistry.cpp.
QLibrary * QgsProviderRegistry::createProviderLibrary | ( | const QString & | providerKey | ) | const |
Returns a new QLibrary for the specified providerKey.
Ownership of the returned object is transferred to the caller and the caller is responsible for deleting it.
If the provider uses direct provider function pointers instead of a library nullptr will be returned.
Definition at line 488 of file qgsproviderregistry.cpp.
QWidget * QgsProviderRegistry::createSelectionWidget | ( | const QString & | providerKey, |
QWidget * | parent = nullptr , |
||
Qt::WindowFlags | fl = Qt::WindowFlags() , |
||
QgsProviderRegistry::WidgetMode | widgetMode = QgsProviderRegistry::WidgetMode::None |
||
) |
Returns a new widget for selecting layers from a provider.
Either the parent widget must be set or the caller becomes responsible for deleting the returned widget.
Definition at line 454 of file qgsproviderregistry.cpp.
|
virtual |
Return a string containing the available database drivers.
Definition at line 531 of file qgsproviderregistry.cpp.
|
virtual |
Return a string containing the available directory drivers.
Definition at line 536 of file qgsproviderregistry.cpp.
|
virtual |
Return raster file filter string.
Returns a string suitable for a QFileDialog of raster file formats supported by all data providers.
This walks through all data providers appending calls to their buildSupportedRasterFileFilter to a string, which is then returned.
Definition at line 526 of file qgsproviderregistry.cpp.
|
virtual |
Return vector file filter string.
Returns a string suitable for a QFileDialog of vector file formats supported by all data providers.
This walks through all data providers appending calls to their fileVectorFilters to a string, which is then returned.
It'd be nice to eventually be raster/vector neutral.
Definition at line 521 of file qgsproviderregistry.cpp.
QFunctionPointer QgsProviderRegistry::function | ( | const QString & | providerKey, |
const QString & | functionName | ||
) |
Get pointer to provider function.
providerKey | identificator of the provider |
functionName | name of function |
Definition at line 466 of file qgsproviderregistry.cpp.
|
static |
Means of accessing canonical single instance.
Definition at line 50 of file qgsproviderregistry.cpp.
QString QgsProviderRegistry::library | ( | const QString & | providerKey | ) | const |
Return path for the library of the provider.
If the provider uses direct provider function pointers instead of a library an empty string will be returned.
Definition at line 297 of file qgsproviderregistry.cpp.
QDir QgsProviderRegistry::libraryDirectory | ( | ) | const |
Returns the library directory where plugins are found.
Definition at line 350 of file qgsproviderregistry.cpp.
QString QgsProviderRegistry::pluginList | ( | bool | asHtml = false | ) | const |
Return list of provider plugins found.
Definition at line 310 of file qgsproviderregistry.cpp.
|
virtual |
Return a string containing the available protocol drivers.
Definition at line 541 of file qgsproviderregistry.cpp.
int QgsProviderRegistry::providerCapabilities | ( | const QString & | providerKey | ) | const |
Return the provider capabilities.
providerKey | identificator of the provider |
Definition at line 434 of file qgsproviderregistry.cpp.
QStringList QgsProviderRegistry::providerList | ( | ) | const |
Return list of available providers by their keys.
Definition at line 546 of file qgsproviderregistry.cpp.
const QgsProviderMetadata * QgsProviderRegistry::providerMetadata | ( | const QString & | providerKey | ) | const |
Return metadata of the provider or NULL if not found.
Definition at line 556 of file qgsproviderregistry.cpp.
void QgsProviderRegistry::registerGuis | ( | QWidget * | widget | ) |
Definition at line 506 of file qgsproviderregistry.cpp.
void QgsProviderRegistry::setLibraryDirectory | ( | const QDir & | path | ) |
Set library directory where to search for plugins.
Definition at line 343 of file qgsproviderregistry.cpp.