Abstract base Data Source Widget to create connections and add layers This class provides common functionality and the interface for all source select dialogs used by data providers to configure data sources and add layers. More...

#include <qgsabstractdatasourcewidget.h>

Inheritance diagram for QgsAbstractDataSourceWidget:

[legend]

Public Slots
virtual void	addButtonClicked ()
	Triggered when the add button is clicked, the add layer signal is emitted Concrete classes should implement the right behavior depending on the layer being added.

virtual bool	configureFromUri (const QString &uri)
	Configure the widget from a layer uri by selecting the layer path or connection options.

virtual void	refresh ()
	Triggered when the provider's connections need to be refreshed The default implementation does nothing.

virtual void	reset ()
	Called when this source select widget is being shown in a "new and clean" dialog.

Signals
void	addDatabaseLayers (const QStringList &paths, const QString &providerKey)
	Emitted when a DB layer has been selected for addition.

void	addLayer (Qgis::LayerType type, const QString &url, const QString &baseName, const QString &providerKey)
	Emitted when a layer has been selected for addition.

Q_DECL_DEPRECATED void	addMeshLayer (const QString &url, const QString &baseName, const QString &providerKey)
	Emitted when a mesh layer has been selected for addition.

Q_DECL_DEPRECATED void	addPointCloudLayer (const QString &url, const QString &baseName, const QString &providerKey)
	Emitted when a point cloud layer has been selected for addition.

Q_DECL_DEPRECATED void	addRasterLayer (const QString &rasterLayerPath, const QString &baseName, const QString &providerKey)
	Emitted when a raster layer has been selected for addition.

void	addRasterLayers (const QStringList &layersList)
	Emitted when one or more GDAL supported layers are selected for addition.

Q_DECL_DEPRECATED void	addVectorLayer (const QString &uri, const QString &layerName, const QString &providerKey=QString())
	Emitted when a vector layer has been selected for addition.

void	addVectorLayers (const QStringList &layerList, const QString &encoding, const QString &dataSourceType)
	Emitted when one or more OGR supported layers are selected for addition.

Q_DECL_DEPRECATED void	addVectorTileLayer (const QString &url, const QString &baseName)
	Emitted when a vector tile layer has been selected for addition.

void	connectionsChanged ()
	Emitted when the provider's connections have changed This signal is normally forwarded the app and used to refresh browser items.

void	enableButtons (bool enable)
	Emitted when the ok/add buttons should be enabled/disabled.

Q_DECL_DEPRECATED void	progress (int, int)
	Emitted when a progress dialog is shown by the provider dialog.

void	progressMessage (QString message)
	Emitted when a progress dialog is shown by the provider dialog.

void	pushMessage (const QString &title, const QString &message, const Qgis::MessageLevel level=Qgis::MessageLevel::Info)
	Emitted when a message with title and level must be shown to the user using the parent visible message bar.

void	replaceVectorLayer (const QString &oldId, const QString &source, const QString &name, const QString &provider)
	Emitted when a layer needs to be replaced.

Public Member Functions
virtual QgsMapCanvas *	mapCanvas ()
	Returns the dialog map canvas.

virtual void	setBrowserModel (QgsBrowserModel *model)
	Sets a browser model to use with the widget.

virtual void	setMapCanvas (QgsMapCanvas *mapCanvas)
	Sets the dialog map canvas.

Protected Member Functions
	QgsAbstractDataSourceWidget (QWidget *parent=nullptr, Qt::WindowFlags fl=QgsGuiUtils::ModalDialogFlags, QgsProviderRegistry::WidgetMode widgetMode=QgsProviderRegistry::WidgetMode::Standalone)
	Constructor.

QPushButton *	addButton () const
	Returns the add Button.

QgsBrowserModel *	browserModel ()
	Returns the associated browser model (may be `nullptr`).

void	setupButtons (QDialogButtonBox *buttonBox)
	Connect the ok and apply/add buttons to the slots.

QgsProviderRegistry::WidgetMode	widgetMode () const
	Returns the widget mode.

Detailed Description

Abstract base Data Source Widget to create connections and add layers This class provides common functionality and the interface for all source select dialogs used by data providers to configure data sources and add layers.

The implementation is generic enough to handle other layer search and selection widgets.

Definition at line 45 of file qgsabstractdatasourcewidget.h.

Constructor & Destructor Documentation

◆ QgsAbstractDataSourceWidget()

QgsAbstractDataSourceWidget::QgsAbstractDataSourceWidget	(	QWidget *	parent = `nullptr`,
		Qt::WindowFlags	fl = `QgsGuiUtils::ModalDialogFlags`,
		QgsProviderRegistry::WidgetMode	widgetMode = `QgsProviderRegistry::WidgetMode::Standalone`
	)

protected

Constructor.

Definition at line 23 of file qgsabstractdatasourcewidget.cpp.

Member Function Documentation

◆ addButton()

QPushButton * QgsAbstractDataSourceWidget::addButton ( ) const

inlineprotected

Returns the add Button.

Definition at line 231 of file qgsabstractdatasourcewidget.h.

◆ addButtonClicked

void QgsAbstractDataSourceWidget::addButtonClicked ( )

virtualslot

Triggered when the add button is clicked, the add layer signal is emitted Concrete classes should implement the right behavior depending on the layer being added.

Definition at line 62 of file qgsabstractdatasourcewidget.cpp.

◆ addDatabaseLayers

void QgsAbstractDataSourceWidget::addDatabaseLayers	(	const QStringList &	paths,
		const QString &	providerKey
	)

signal

Emitted when a DB layer has been selected for addition.

◆ addLayer

void QgsAbstractDataSourceWidget::addLayer	(	Qgis::LayerType	type,
		const QString &	url,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a layer has been selected for addition.

This is a generic method, intended for replacing the specific layer type signals implemented above.

Warning: For QGIS versions < 4.x, the specific layer type added signals must be emitted for vector, raster, mesh, vector tile and point cloud layers in addition to this signal.

Since: QGIS 3.34

◆ addMeshLayer

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::addMeshLayer	(	const QString &	url,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a mesh layer has been selected for addition.

Deprecated:: QGIS 3.40. Use addLayer() instead.

◆ addPointCloudLayer

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::addPointCloudLayer	(	const QString &	url,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a point cloud layer has been selected for addition.

Deprecated:: QGIS 3.40. Use addLayer() instead.

◆ addRasterLayer

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::addRasterLayer	(	const QString &	rasterLayerPath,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a raster layer has been selected for addition.

Deprecated:: QGIS 3.40. Use addLayer() instead.

◆ addRasterLayers

void QgsAbstractDataSourceWidget::addRasterLayers ( const QStringList & layersList )

signal

Emitted when one or more GDAL supported layers are selected for addition.

Parameters

layersList list of layers protocol URIs

Since: QGIS 3.20

◆ addVectorLayer

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::addVectorLayer	(	const QString &	uri,
		const QString &	layerName,
		const QString &	providerKey = `QString()`
	)

signal

Emitted when a vector layer has been selected for addition.

If providerKey is not specified, the default provider key associated with the source will be used.

Deprecated:: QGIS 3.40. Use addLayer() instead.

◆ addVectorLayers

void QgsAbstractDataSourceWidget::addVectorLayers	(	const QStringList &	layerList,
		const QString &	encoding,
		const QString &	dataSourceType
	)

signal

Emitted when one or more OGR supported layers are selected for addition.

Parameters

layerList	list of layers protocol URIs
encoding	encoding
dataSourceType	string (can be "file" or "database")

◆ addVectorTileLayer

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::addVectorTileLayer	(	const QString &	url,
		const QString &	baseName
	)

signal

Emitted when a vector tile layer has been selected for addition.

Deprecated:: QGIS 3.40. Use addLayer() instead.

◆ browserModel()

QgsBrowserModel * QgsAbstractDataSourceWidget::browserModel ( )

protected

Returns the associated browser model (may be nullptr).

Since: QGIS 3.18

Definition at line 34 of file qgsabstractdatasourcewidget.cpp.

◆ configureFromUri

bool QgsAbstractDataSourceWidget::configureFromUri ( const QString & uri )

virtualslot

Configure the widget from a layer uri by selecting the layer path or connection options.

The base implementation does nothing and returns false: providers with ConfigureSourceSelectFromUri capability must override to implement this functionality.

Returns: true on success.

Note: Not all data providers may be able to configure the widget from the provided uri, in that case this method returns false.

Since: QGIS 3.38

Definition at line 70 of file qgsabstractdatasourcewidget.cpp.

◆ connectionsChanged

void QgsAbstractDataSourceWidget::connectionsChanged ( )

signal

Emitted when the provider's connections have changed This signal is normally forwarded the app and used to refresh browser items.

◆ enableButtons

void QgsAbstractDataSourceWidget::enableButtons ( bool enable )

signal

Emitted when the ok/add buttons should be enabled/disabled.

◆ mapCanvas()

virtual QgsMapCanvas * QgsAbstractDataSourceWidget::mapCanvas ( )

inlinevirtual

Returns the dialog map canvas.

See also: setMapCanvas()

Definition at line 64 of file qgsabstractdatasourcewidget.h.

◆ progress

Q_DECL_DEPRECATED void QgsAbstractDataSourceWidget::progress	(	int	,
		int
	)

signal

Emitted when a progress dialog is shown by the provider dialog.

Deprecated:: QGIS 3.4. This signal is no longer used. Use QgsProxyProgressTask instead to show progress reports.

◆ progressMessage

void QgsAbstractDataSourceWidget::progressMessage ( QString message )

signal

Emitted when a progress dialog is shown by the provider dialog.

◆ pushMessage

void QgsAbstractDataSourceWidget::pushMessage	(	const QString &	title,
		const QString &	message,
		const Qgis::MessageLevel	level = `Qgis::MessageLevel::Info`
	)

signal

Emitted when a message with title and level must be shown to the user using the parent visible message bar.

Since: QGIS 3.14

◆ refresh

virtual void QgsAbstractDataSourceWidget::refresh ( )

inlinevirtualslot

Triggered when the provider's connections need to be refreshed The default implementation does nothing.

Reimplemented in QgsOWSSourceSelect.

Definition at line 78 of file qgsabstractdatasourcewidget.h.

◆ replaceVectorLayer

void QgsAbstractDataSourceWidget::replaceVectorLayer	(	const QString &	oldId,
		const QString &	source,
		const QString &	name,
		const QString &	provider
	)

signal

Emitted when a layer needs to be replaced.

Parameters

oldId	old layer ID
source	URI of the layer
name	of the layer
provider	key

◆ reset

void QgsAbstractDataSourceWidget::reset ( )

virtualslot

Called when this source select widget is being shown in a "new and clean" dialog.

The data source manager recycles existing source select widgets but will call this method on every reopening. This should clear any selection that has previously been done.

Since: QGIS 3.10

Reimplemented in QgsOWSSourceSelect.

Definition at line 66 of file qgsabstractdatasourcewidget.cpp.

◆ setBrowserModel()

void QgsAbstractDataSourceWidget::setBrowserModel ( QgsBrowserModel * model )

virtual

Sets a browser model to use with the widget.

See also: browserModel()

Since: QGIS 3.18

Definition at line 57 of file qgsabstractdatasourcewidget.cpp.

◆ setMapCanvas()

virtual void QgsAbstractDataSourceWidget::setMapCanvas ( QgsMapCanvas * mapCanvas )

inlinevirtual

Sets the dialog map canvas.

See also: mapCanvas()

Reimplemented in QgsLayerMetadataSearchWidget, and QgsOWSSourceSelect.

Definition at line 70 of file qgsabstractdatasourcewidget.h.

◆ setupButtons()

void QgsAbstractDataSourceWidget::setupButtons ( QDialogButtonBox * buttonBox )

protected

Connect the ok and apply/add buttons to the slots.

Definition at line 39 of file qgsabstractdatasourcewidget.cpp.

◆ widgetMode()

QgsProviderRegistry::WidgetMode QgsAbstractDataSourceWidget::widgetMode ( ) const

protected

Returns the widget mode.

Definition at line 29 of file qgsabstractdatasourcewidget.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.41.0+git20241110+fda2aa46e9a+99sid/src/gui/qgsabstractdatasourcewidget.h
/build/qgis-3.41.0+git20241110+fda2aa46e9a+99sid/src/gui/qgsabstractdatasourcewidget.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsAbstractDataSourceWidget()

Member Function Documentation

◆ addButton()

◆ addButtonClicked

◆ addDatabaseLayers

◆ addLayer

◆ addMeshLayer

◆ addPointCloudLayer

◆ addRasterLayer

◆ addRasterLayers

◆ addVectorLayer

◆ addVectorLayers

◆ addVectorTileLayer

◆ browserModel()

◆ configureFromUri

◆ connectionsChanged

◆ enableButtons

◆ mapCanvas()

◆ progress

◆ progressMessage

◆ pushMessage

◆ refresh

◆ replaceVectorLayer

◆ reset

◆ setBrowserModel()

◆ setMapCanvas()

◆ setupButtons()

◆ widgetMode()