Class: QgsSourceSelectProvider

This is the interface for those who want to add entries to the QgsDataSourceManagerDialog

class qgis.gui.QgsSourceSelectProvider[source]

Bases: object

class Capabilities
class Capabilities(f: QgsSourceSelectProvider.Capabilities | QgsSourceSelectProvider.Capability)
class Capabilities(a0: QgsSourceSelectProvider.Capabilities)

Bases: object

class Capability(*values)

Bases: IntEnum

The Capability enum describes the capabilities of the source select implementation.

Added in version 3.38.

  • NoCapabilities: No capabilities

  • ConfigureFromUri: The source select widget can be configured from a URI

ConfigureFromUri = 1
NoCapabilities = 0
OrderDatabaseProvider = 1000
OrderLocalProvider = 0
OrderOtherProvider = 5000
OrderRemoteProvider = 2000
OrderSearchProvider = 4000
class Ordering

Bases: int

capabilities(self) QgsSourceSelectProvider.Capabilities[source]

Returns the source select provider capabilities. The default implementation returns no capabilities.

Added in version 3.38.

Return type:

QgsSourceSelectProvider.Capabilities

createDataSourceWidget(self, parent: QWidget | None = None, fl: Qt.WindowFlags | Qt.WindowType = Qt.Widget, widgetMode: QgsProviderRegistry.WidgetMode = QgsProviderRegistry.WidgetMode.Embedded) QgsAbstractDataSourceWidget | None[source]

Create a new instance of QgsAbstractDataSourceWidget (or None). Caller takes responsibility of deleting created.

Parameters:
  • parent (Optional[QWidget] = None)

  • fl (Union[Qt.WindowFlags, Qt.WindowType] = Qt.Widget)

  • widgetMode (QgsProviderRegistry.WidgetMode = QgsProviderRegistry.WidgetMode.Embedded)

Return type:

Optional[QgsAbstractDataSourceWidget]

icon(self) QIcon[source]

Creates a new instance of an QIcon for the menu item entry

Return type:

QIcon

name(self) str[source]

Source select provider name, this is useful to retrieve a particular source select in case the provider has more than one, it should be unique among all providers.

The default implementation returns the providerKey()

Return type:

str

ordering(self) int[source]

Ordering: the source select provider registry will be able to sort the source selects (ascending) using this integer value

Return type:

int

providerKey(self) str[source]

Data Provider key

Return type:

str

text(self) str[source]

Text for the menu item entry, it will be visible to the user so make sure it’s translatable

Return type:

str

toolTip(self) str[source]

Text for the tooltip menu item entry, it will be visible to the user so make sure it’s translatable

The default implementation returns an empty string.

Return type:

str