The QgsDataSourceManagerDialog class embeds the browser panel and all the provider dialogs. The dialog does not handle layer addition directly but emits signals that need to be forwarded to the QGIS application to be handled. More...

#include <qgsdatasourcemanagerdialog.h>

Inheritance diagram for QgsDataSourceManagerDialog:

[legend]

Public Slots
void	rasterLayerAdded (QString const &uri, QString const &baseName, QString const &providerKey)
	A raster layer was added: for signal forwarding to QgisApp. More...

void	rasterLayersAdded (const QStringList &layersList)
	One or more raster layer were added: for signal forwarding to QgisApp. More...

void	refresh ()
	Refresh the browser view. More...

void	reset ()
	Resets the interface of the datasource manager after reopening the dialog. More...

void	setCurrentPage (int index)
	Sync current page with the leftbar list. More...

void	setPreviousPage ()
	Reset current page to previously selected page. More...

void	vectorLayerAdded (const QString &vectorLayerPath, const QString &baseName, const QString &providerKey)
	A vector layer was added: for signal forwarding to QgisApp. More...

void	vectorLayersAdded (const QStringList &layerQStringList, const QString &enc, const QString &dataSourceType)
	One or more vector layer were added: for signal forwarding to QgisApp. More...

Public Slots inherited from QgsOptionsDialogBase
void	searchText (const QString &text)
	searchText searches for a text in all the pages of the stacked widget and highlight the results More...

Signals
void	addDatabaseLayers (const QStringList &layerPathList, const QString &providerKey)
	Emitted when a DB layer was selected for addition: for signal forwarding to QgisApp. More...

void	addMeshLayer (const QString &uri, const QString &baseName, const QString &providerKey)
	Emitted when a mesh layer was selected for addition: for signal forwarding to QgisApp. More...

void	addPointCloudLayer (const QString &pointCloudLayerPath, const QString &baseName, const QString &providerKey)
	Emitted when a point cloud layer was selected for addition: for signal forwarding to QgisApp. More...

void	addRasterLayer (const QString &uri, const QString &baseName, const QString &providerKey)
	Emitted when a raster layer was selected for addition: for signal forwarding to QgisApp. More...

void	addRasterLayers (const QStringList &layersList)
	Emitted when a one or more layer were selected for addition: for signal forwarding to QgisApp. More...

void	addVectorLayer (const QString &vectorLayerPath, const QString &baseName, const QString &providerKey)
	Emitted when a vector layer was selected for addition: for signal forwarding to QgisApp. More...

void	addVectorLayers (const QStringList &layerQStringList, const QString &enc, const QString &dataSourceType)
	Emitted when a one or more layer were selected for addition: for signal forwarding to QgisApp. More...

void	addVectorTileLayer (const QString &uri, const QString &baseName)
	Emitted when a vector tile layer was selected for addition: for signal forwarding to QgisApp. More...

void	connectionsChanged ()
	Emitted when a connection has changed inside the provider dialogs This signal is normally forwarded to the application to notify other browsers that they need to refresh their connections list. More...

void	handleDropUriList (const QgsMimeDataUtils::UriList &)
	Emitted when drop uri list needs to be handled from the browser. More...

void	openFile (const QString &fileName, const QString &fileTypeHint=QString())
	Emitted when a file needs to be opened. More...

void	providerDialogsRefreshRequested ()
	One or more provider connections have changed and the dialogs should be refreshed. More...

void	replaceSelectedVectorLayer (const QString &oldId, const QString &uri, const QString &layerName, const QString &provider)
	Replace the selected layer by a vector layer defined by uri, layer name, data source uri. More...

void	showStatusMessage (const QString &message)
	Emitted when a status message needs to be shown: for signal forwarding to QgisApp. More...

void	updateProjectHome ()
	Update project home directory. More...

Public Member Functions
	QgsDataSourceManagerDialog (QgsBrowserGuiModel browserModel, QWidget parent=nullptr, QgsMapCanvas *canvas=nullptr, Qt::WindowFlags fl=QgsGuiUtils::ModalDialogFlags)
	QgsDataSourceManagerDialog constructor. More...

	~QgsDataSourceManagerDialog () override

QgsMessageBar *	messageBar () const
	Returns the dialog's message bar. More...

void	openPage (const QString &pageName)
	Open a given page in the dialog. More...

Public Member Functions inherited from QgsOptionsDialogBase
	QgsOptionsDialogBase (const QString &settingsKey, QWidget parent=nullptr, Qt::WindowFlags fl=Qt::WindowFlags(), QgsSettings settings=nullptr)
	Constructor. More...

	~QgsOptionsDialogBase () override

void	addPage (const QString &title, const QString &tooltip, const QIcon &icon, QWidget *widget, const QStringList &path=QStringList())
	Adds a new page to the dialog pages. More...

bool	iconOnly ()
	Determine if the options list is in icon only mode. More...

void	initOptionsBase (bool restoreUi=true, const QString &title=QString())
	Set up the base ui connections for vertical tabs. More...

void	insertPage (const QString &title, const QString &tooltip, const QIcon &icon, QWidget *widget, const QString &before, const QStringList &path=QStringList())
	Inserts a new page into the dialog pages. More...

void	resizeAlltabs (int index)
	Resizes all tabs when the dialog is resized. More...

void	restoreLastPage ()
	Refocus the active tab from the last time the dialog was shown. More...

void	restoreOptionsBaseUi (const QString &title=QString())
	Restore the base ui. More...

void	setCurrentPage (const QString &page)
	Sets the dialog page (by object name) to show. More...

void	setSettings (QgsSettings *settings)

Protected Member Functions
void	showEvent (QShowEvent *event) override

Protected Member Functions inherited from QgsOptionsDialogBase
QStandardItem *	createItem (const QString &name, const QString &tooltip, const QString &icon)
	Creates a new QStandardItem with the specified name, tooltip and icon. More...

void	paintEvent (QPaintEvent *e) override

void	registerTextSearchWidgets ()
	register widgets in the dialog to search for text in it it is automatically called if a line edit has "mSearchLineEdit" as object name. More...

void	showEvent (QShowEvent *e) override

virtual void	updateWindowTitle ()

Additional Inherited Members
Protected Slots inherited from QgsOptionsDialogBase
virtual void	optionsStackedWidget_CurrentChanged (int index)
	Select relevant tab on current page change. More...

virtual void	optionsStackedWidget_WidgetRemoved (int index)
	Remove tab and unregister widgets on page remove. More...

virtual void	updateOptionsListVerticalTabs ()
	Update tabs on the splitter move. More...

void	warnAboutMissingObjects ()

Protected Attributes inherited from QgsOptionsDialogBase
bool	mDelSettings = false

QString	mDialogTitle

bool	mIconOnly = false

bool	mInit = false

QDialogButtonBox *	mOptButtonBox = nullptr

QListWidget *	mOptListWidget = nullptr

QString	mOptsKey

QSplitter *	mOptSplitter = nullptr

QStackedWidget *	mOptStackedWidget = nullptr

QStandardItemModel *	mOptTreeModel = nullptr

QTreeView *	mOptTreeView = nullptr

QList< QPair< QgsOptionsDialogHighlightWidget *, int > >	mRegisteredSearchWidgets

QgsFilterLineEdit *	mSearchLineEdit = nullptr

QPointer< QgsSettings >	mSettings

QgsOptionsProxyModel *	mTreeProxyModel = nullptr

Detailed Description

The QgsDataSourceManagerDialog class embeds the browser panel and all the provider dialogs. The dialog does not handle layer addition directly but emits signals that need to be forwarded to the QGIS application to be handled.

Note: not available in Python bindings

Since: QGIS 3.0

Definition at line 47 of file qgsdatasourcemanagerdialog.h.

Constructor & Destructor Documentation

◆ QgsDataSourceManagerDialog()

QgsDataSourceManagerDialog::QgsDataSourceManagerDialog	(	QgsBrowserGuiModel *	browserModel,
		QWidget *	parent = `nullptr`,
		QgsMapCanvas *	canvas = `nullptr`,
		Qt::WindowFlags	fl = `QgsGuiUtils::ModalDialogFlags`
	)

explicit

QgsDataSourceManagerDialog constructor.

Parameters

browserModel	instance of the (shared) browser model
parent	the object
canvas	a pointer to the map canvas
fl	window flags

Definition at line 34 of file qgsdatasourcemanagerdialog.cpp.

◆ ~QgsDataSourceManagerDialog()

QgsDataSourceManagerDialog::~QgsDataSourceManagerDialog ( )

override

Definition at line 84 of file qgsdatasourcemanagerdialog.cpp.

Member Function Documentation

◆ addDatabaseLayers

void QgsDataSourceManagerDialog::addDatabaseLayers	(	const QStringList &	layerPathList,
		const QString &	providerKey
	)

signal

Emitted when a DB layer was selected for addition: for signal forwarding to QgisApp.

◆ addMeshLayer

void QgsDataSourceManagerDialog::addMeshLayer	(	const QString &	uri,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a mesh layer was selected for addition: for signal forwarding to QgisApp.

Since: QGIS 3.4

◆ addPointCloudLayer

void QgsDataSourceManagerDialog::addPointCloudLayer	(	const QString &	pointCloudLayerPath,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a point cloud layer was selected for addition: for signal forwarding to QgisApp.

Since: QGIS 3.18

◆ addRasterLayer

void QgsDataSourceManagerDialog::addRasterLayer	(	const QString &	uri,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a raster layer was selected for addition: for signal forwarding to QgisApp.

◆ addRasterLayers

void QgsDataSourceManagerDialog::addRasterLayers ( const QStringList & layersList )

signal

Emitted when a one or more layer were selected for addition: for signal forwarding to QgisApp.

Since: QGIS 3.20

◆ addVectorLayer

void QgsDataSourceManagerDialog::addVectorLayer	(	const QString &	vectorLayerPath,
		const QString &	baseName,
		const QString &	providerKey
	)

signal

Emitted when a vector layer was selected for addition: for signal forwarding to QgisApp.

◆ addVectorLayers

void QgsDataSourceManagerDialog::addVectorLayers	(	const QStringList &	layerQStringList,
		const QString &	enc,
		const QString &	dataSourceType
	)

signal

Emitted when a one or more layer were selected for addition: for signal forwarding to QgisApp.

◆ addVectorTileLayer

void QgsDataSourceManagerDialog::addVectorTileLayer	(	const QString &	uri,
		const QString &	baseName
	)

signal

Emitted when a vector tile layer was selected for addition: for signal forwarding to QgisApp.

Since: QGIS 3.14

◆ connectionsChanged

void QgsDataSourceManagerDialog::connectionsChanged ( )

signal

Emitted when a connection has changed inside the provider dialogs This signal is normally forwarded to the application to notify other browsers that they need to refresh their connections list.

◆ handleDropUriList

void QgsDataSourceManagerDialog::handleDropUriList ( const QgsMimeDataUtils::UriList & )

signal

Emitted when drop uri list needs to be handled from the browser.

◆ messageBar()

QgsMessageBar * QgsDataSourceManagerDialog::messageBar ( ) const

Returns the dialog's message bar.

Definition at line 98 of file qgsdatasourcemanagerdialog.cpp.

◆ openFile

void QgsDataSourceManagerDialog::openFile	(	const QString &	fileName,
		const QString &	fileTypeHint = `QString()`
	)

signal

Emitted when a file needs to be opened.

◆ openPage()

void QgsDataSourceManagerDialog::openPage ( const QString & pageName )

Open a given page in the dialog.

Parameters

pageName the page name, usually the provider name or "browser" (for the browser panel) or "ogr" (vector layers) or "raster" (raster layers)

Definition at line 89 of file qgsdatasourcemanagerdialog.cpp.

◆ providerDialogsRefreshRequested

void QgsDataSourceManagerDialog::providerDialogsRefreshRequested ( )

signal

One or more provider connections have changed and the dialogs should be refreshed.

◆ rasterLayerAdded

void QgsDataSourceManagerDialog::rasterLayerAdded	(	QString const &	uri,
		QString const &	baseName,
		QString const &	providerKey
	)

slot

A raster layer was added: for signal forwarding to QgisApp.

Definition at line 135 of file qgsdatasourcemanagerdialog.cpp.

◆ rasterLayersAdded

void QgsDataSourceManagerDialog::rasterLayersAdded ( const QStringList & layersList )

slot

One or more raster layer were added: for signal forwarding to QgisApp.

Since: QGIS 3.20

Definition at line 140 of file qgsdatasourcemanagerdialog.cpp.

◆ refresh

void QgsDataSourceManagerDialog::refresh ( )

slot

Refresh the browser view.

Definition at line 117 of file qgsdatasourcemanagerdialog.cpp.

◆ replaceSelectedVectorLayer

void QgsDataSourceManagerDialog::replaceSelectedVectorLayer	(	const QString &	oldId,
		const QString &	uri,
		const QString &	layerName,
		const QString &	provider
	)

signal

Replace the selected layer by a vector layer defined by uri, layer name, data source uri.

◆ reset

void QgsDataSourceManagerDialog::reset ( )

slot

Resets the interface of the datasource manager after reopening the dialog.

Will clear the selection of embedded all source selection widgets.

Since: QGIS 3.10

Definition at line 123 of file qgsdatasourcemanagerdialog.cpp.

◆ setCurrentPage

void QgsDataSourceManagerDialog::setCurrentPage ( int index )

slot

Sync current page with the leftbar list.

Definition at line 103 of file qgsdatasourcemanagerdialog.cpp.

◆ setPreviousPage

void QgsDataSourceManagerDialog::setPreviousPage ( )

slot

Reset current page to previously selected page.

Definition at line 111 of file qgsdatasourcemanagerdialog.cpp.

◆ showEvent()

void QgsDataSourceManagerDialog::showEvent ( QShowEvent * event )

overrideprotected

Definition at line 219 of file qgsdatasourcemanagerdialog.cpp.

◆ showStatusMessage

void QgsDataSourceManagerDialog::showStatusMessage ( const QString & message )

signal

Emitted when a status message needs to be shown: for signal forwarding to QgisApp.

◆ updateProjectHome

void QgsDataSourceManagerDialog::updateProjectHome ( )

signal

Update project home directory.

◆ vectorLayerAdded

void QgsDataSourceManagerDialog::vectorLayerAdded	(	const QString &	vectorLayerPath,
		const QString &	baseName,
		const QString &	providerKey
	)

slot

A vector layer was added: for signal forwarding to QgisApp.

Definition at line 145 of file qgsdatasourcemanagerdialog.cpp.

◆ vectorLayersAdded

void QgsDataSourceManagerDialog::vectorLayersAdded	(	const QStringList &	layerQStringList,
		const QString &	enc,
		const QString &	dataSourceType
	)

slot

One or more vector layer were added: for signal forwarding to QgisApp.

Definition at line 150 of file qgsdatasourcemanagerdialog.cpp.

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

/build/qgis-3.26.3+32focal/src/gui/qgsdatasourcemanagerdialog.h
/build/qgis-3.26.3+32focal/src/gui/qgsdatasourcemanagerdialog.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsDataSourceManagerDialog()

◆ ~QgsDataSourceManagerDialog()

Member Function Documentation

◆ addDatabaseLayers

◆ addMeshLayer

◆ addPointCloudLayer

◆ addRasterLayer

◆ addRasterLayers

◆ addVectorLayer

◆ addVectorLayers

◆ addVectorTileLayer

◆ connectionsChanged

◆ handleDropUriList

◆ messageBar()

◆ openFile

◆ openPage()

◆ providerDialogsRefreshRequested

◆ rasterLayerAdded

◆ rasterLayersAdded

◆ refresh

◆ replaceSelectedVectorLayer

◆ reset

◆ setCurrentPage

◆ setPreviousPage

◆ showEvent()

◆ showStatusMessage

◆ updateProjectHome

◆ vectorLayerAdded

◆ vectorLayersAdded