This class manages all known edit widget factories. More...

#include <qgseditorwidgetregistry.h>

Inheritance diagram for QgsEditorWidgetRegistry:

Public Member Functions
	QgsEditorWidgetRegistry ()
	Constructor for QgsEditorWidgetRegistry.

	~QgsEditorWidgetRegistry () override
	Destructor.

QgsEditorWidgetWrapper *	create (const QString &widgetId, QgsVectorLayer vl, int fieldIdx, const QVariantMap &config, QWidget editor, QWidget *parent, const QgsAttributeEditorContext &context=QgsAttributeEditorContext())
	Create an attribute editor widget wrapper of a given type for a given field.

QgsEditorWidgetWrapper *	create (QgsVectorLayer vl, int fieldIdx, QWidget editor, QWidget *parent, const QgsAttributeEditorContext &context=QgsAttributeEditorContext())
	Create an attribute editor widget wrapper of the best type for a given field.

QgsEditorConfigWidget *	createConfigWidget (const QString &widgetId, QgsVectorLayer vl, int fieldIdx, QWidget parent)
	Creates a configuration widget.

QgsSearchWidgetWrapper *	createSearchWidget (const QString &widgetId, QgsVectorLayer vl, int fieldIdx, const QVariantMap &config, QWidget parent, const QgsAttributeEditorContext &context=QgsAttributeEditorContext())

QMap< QString, QgsEditorWidgetFactory * >	factories ()
	Gets access to all registered factories.

QgsEditorWidgetFactory *	factory (const QString &widgetId)
	Gets a factory for the given widget type id.

QgsEditorWidgetSetup	findBest (const QgsVectorLayer *vl, const QString &fieldName) const
	Find the best editor widget and its configuration for a given field.

void	initEditors (QgsMapCanvas mapCanvas=nullptr, QgsMessageBar messageBar=nullptr)
	Registers all the default widgets.

QString	name (const QString &widgetId)
	Gets the human readable name for a widget type.

void	registerAutoConfPlugin (QgsEditorWidgetAutoConfPlugin *plugin)
	Register a new auto-conf plugin.

bool	registerWidget (const QString &widgetId, QgsEditorWidgetFactory *widgetFactory)
	Register a new widget factory with the given id.

Detailed Description

This class manages all known edit widget factories.

QgsEditorWidgetRegistry is not usually directly created, but rather accessed through QgsGui::editorWidgetRegistry().

Definition at line 44 of file qgseditorwidgetregistry.h.

Constructor & Destructor Documentation

◆ QgsEditorWidgetRegistry()

QgsEditorWidgetRegistry::QgsEditorWidgetRegistry ( )

Constructor for QgsEditorWidgetRegistry.

QgsEditorWidgetRegistry is not usually directly created, but rather accessed through QgsGui::editorWidgetRegistry().

Definition at line 48 of file qgseditorwidgetregistry.cpp.

◆ ~QgsEditorWidgetRegistry()

QgsEditorWidgetRegistry::~QgsEditorWidgetRegistry ( )

override

Destructor.

Deletes all the registered widgets

Definition at line 76 of file qgseditorwidgetregistry.cpp.

Member Function Documentation

◆ create() [1/2]

QgsEditorWidgetWrapper * QgsEditorWidgetRegistry::create	(	const QString &	widgetId,
		QgsVectorLayer *	vl,
		int	fieldIdx,
		const QVariantMap &	config,
		QWidget *	editor,
		QWidget *	parent,
		const QgsAttributeEditorContext &	context = `QgsAttributeEditorContext()`
	)

Create an attribute editor widget wrapper of a given type for a given field.

The editor may be nullptr if you want the widget wrapper to create a default widget.

Parameters

widgetId	The id of the widget type to create an attribute editor for
vl	The vector layer for which this widget will be created
fieldIdx	The field index on the specified layer for which this widget will be created
config	A configuration which should be used for the widget creation
editor	An editor widget which will be used instead of an autocreated widget
parent	The parent which will be used for the created wrapper and the created widget
context	The editor context (not available in Python bindings)

Returns: A new widget wrapper

Definition at line 102 of file qgseditorwidgetregistry.cpp.

◆ create() [2/2]

QgsEditorWidgetWrapper * QgsEditorWidgetRegistry::create	(	QgsVectorLayer *	vl,
		int	fieldIdx,
		QWidget *	editor,
		QWidget *	parent,
		const QgsAttributeEditorContext &	context = `QgsAttributeEditorContext()`
	)

Create an attribute editor widget wrapper of the best type for a given field.

The editor may be nullptr if you want the widget wrapper to create a default widget.

Parameters

vl	The vector layer for which this widget will be created
fieldIdx	The field index on the specified layer for which this widget will be created
editor	An editor widget which will be used instead of an autocreated widget
parent	The parent which will be used for the created wrapper and the created widget
context	The editor context (not available in Python bindings)

Returns: A new widget wrapper

Definition at line 95 of file qgseditorwidgetregistry.cpp.

◆ createConfigWidget()

QgsEditorConfigWidget * QgsEditorWidgetRegistry::createConfigWidget	(	const QString &	widgetId,
		QgsVectorLayer *	vl,
		int	fieldIdx,
		QWidget *	parent
	)

Creates a configuration widget.

Parameters

widgetId	The id of the widget type to create a configuration widget for
vl	The vector layer for which this widget will be created
fieldIdx	The field index on the specified layer for which this widget will be created
parent	The parent widget for the created widget

Returns: A new configuration widget

Definition at line 153 of file qgseditorwidgetregistry.cpp.

◆ createSearchWidget()

QgsSearchWidgetWrapper * QgsEditorWidgetRegistry::createSearchWidget	(	const QString &	widgetId,
		QgsVectorLayer *	vl,
		int	fieldIdx,
		const QVariantMap &	config,
		QWidget *	parent,
		const QgsAttributeEditorContext &	context = `QgsAttributeEditorContext()`
	)

Definition at line 133 of file qgseditorwidgetregistry.cpp.

◆ factories()

QMap< QString, QgsEditorWidgetFactory * > QgsEditorWidgetRegistry::factories ( )

Gets access to all registered factories.

Returns: All ids and factories

Definition at line 172 of file qgseditorwidgetregistry.cpp.

◆ factory()

QgsEditorWidgetFactory * QgsEditorWidgetRegistry::factory ( const QString & widgetId )

Gets a factory for the given widget type id.

Returns: A factory or nullptr if not existent

Definition at line 177 of file qgseditorwidgetregistry.cpp.

◆ findBest()

QgsEditorWidgetSetup QgsEditorWidgetRegistry::findBest	(	const QgsVectorLayer *	vl,
		const QString &	fieldName
	)		const

Find the best editor widget and its configuration for a given field.

Parameters

vl	The vector layer for which this widget will be created
fieldName	The field name on the specified layer for which this widget will be created

Returns: The id of the widget type to use and its config

Definition at line 81 of file qgseditorwidgetregistry.cpp.

◆ initEditors()

void QgsEditorWidgetRegistry::initEditors	(	QgsMapCanvas *	mapCanvas = `nullptr`,
		QgsMessageBar *	messageBar = `nullptr`
	)

Registers all the default widgets.

Only call this once on startup of an application.

Parameters

mapCanvas	Specify a map canvas with which the widgets (relation reference) work
messageBar	Specify a message bar on which messages by widgets will be shown while working with the map canvas

Note: Not required for plugins, the QGIS application does that already

Definition at line 53 of file qgseditorwidgetregistry.cpp.

◆ name()

QString QgsEditorWidgetRegistry::name ( const QString & widgetId )

Gets the human readable name for a widget type.

Parameters

widgetId The widget type to get the name for

Returns: A human readable name

Definition at line 162 of file qgseditorwidgetregistry.cpp.

◆ registerAutoConfPlugin()

void QgsEditorWidgetRegistry::registerAutoConfPlugin ( QgsEditorWidgetAutoConfPlugin * plugin )

inline

Register a new auto-conf plugin.

Parameters

plugin The plugin (ownership is transferred)

Definition at line 181 of file qgseditorwidgetregistry.h.

◆ registerWidget()

bool QgsEditorWidgetRegistry::registerWidget	(	const QString &	widgetId,
		QgsEditorWidgetFactory *	widgetFactory
	)

Register a new widget factory with the given id.

Parameters

widgetId	The id which will be used later to refer to this widget type
widgetFactory	The factory which will create this widget type

Returns: true, if successful, false, if the widgetId is already in use or widgetFactory is nullptr

Definition at line 182 of file qgseditorwidgetregistry.cpp.

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

/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/gui/editorwidgets/core/qgseditorwidgetregistry.h
/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/gui/editorwidgets/core/qgseditorwidgetregistry.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsEditorWidgetRegistry()

◆ ~QgsEditorWidgetRegistry()

Member Function Documentation

◆ create() [1/2]

◆ create() [2/2]

◆ createConfigWidget()

◆ createSearchWidget()

◆ factories()

◆ factory()

◆ findBest()

◆ initEditors()

◆ name()

◆ registerAutoConfPlugin()

◆ registerWidget()