Class: QgsRelationWidgetRegistry

class qgis.gui.QgsRelationWidgetRegistry

Bases: sip.wrapper

Keeps track of the registered relations widgets. New widgets can be registered, old ones deleted. The default {QgsRelationEditorWidget} is protected from removing.

New in version 3.18.

QgsRelationWidgetRegistry() Constructor

QgsRelationWidgetRegistry(QgsRelationWidgetRegistry)

Methods

addRelationWidget

Adds a new registered relation widgetFactory

create

Create a relation widget of a given type for a given field.

createConfigWidget

Creates a configuration widget

defaultWidgetType

Returns the default editor widget type.

factories

Gets access to all registered factories

relationWidgetNames

Returns a list of names of registered relation widgets

removeRelationWidget

Removes a registered relation widget with given widgetType

setDefaultWidgetType

Sets the default editor widget type.

addRelationWidget(self, widgetFactory: QgsAbstractRelationEditorWidgetFactory)

Adds a new registered relation widgetFactory

Parameters

widgetFactory (QgsAbstractRelationEditorWidgetFactory) –

create(self, widgetType: str, config: Dict[str, Any], parent: QWidget = None) QgsAbstractRelationEditorWidget

Create a relation widget of a given type for a given field.

Parameters
  • widgetType (str) – The widget type to create a relation editor for

  • config (Dict[str) – The configuration of the widget

  • parent (QWidget = None) –

Return type

QgsAbstractRelationEditorWidget

createConfigWidget(self, widgetType: str, relation: QgsRelation, parent: QWidget = None) QgsAbstractRelationEditorConfigWidget

Creates a configuration widget

Parameters
  • widgetType (str) – The widget type to create a configuration widget for

  • relation (QgsRelation) – The relation for which this widget will be created

  • parent (QWidget = None) – The parent widget for the created widget

Return type

QgsAbstractRelationEditorConfigWidget

defaultWidgetType(self) str

Returns the default editor widget type.

New in version 3.20.

Return type

str

factories(self) object

Gets access to all registered factories

Return type

object

relationWidgetNames(self) List[str]

Returns a list of names of registered relation widgets

Return type

List[str]

removeRelationWidget(self, widgetType: str)

Removes a registered relation widget with given widgetType

Parameters

widgetType (str) –

setDefaultWidgetType(self, widgetType: str)

Sets the default editor widget type. Does nothing if the provided widget type is not present.

Parameters

widgetType (str) – The widget type to be used by default.

New in version 3.20.