QGIS API Documentation  2.7.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsEditorWidgetRegistry Class Reference

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

#include <qgseditorwidgetregistry.h>

Inheritance diagram for QgsEditorWidgetRegistry:
Inheritance graph
[legend]

Public Member Functions

 ~QgsEditorWidgetRegistry ()
 Destructor. More...
 
QgsEditorWidgetWrappercreate (const QString &widgetId, QgsVectorLayer *vl, int fieldIdx, const QgsEditorWidgetConfig &config, QWidget *editor, QWidget *parent, const QgsAttributeEditorContext context=QgsAttributeEditorContext())
 Create an attribute editor widget wrapper of a given type for a given field. More...
 
QgsEditorConfigWidgetcreateConfigWidget (const QString &widgetId, QgsVectorLayer *vl, int fieldIdx, QWidget *parent)
 Creates a configuration widget. More...
 
const QMap< QString,
QgsEditorWidgetFactory * > & 
factories ()
 Get access to all registered factories. More...
 
QgsEditorWidgetFactoryfactory (const QString &widgetId)
 Get a factory for the given widget type id. More...
 
QString name (const QString &widgetId)
 Get the human readable name for a widget type. More...
 
bool registerWidget (const QString &widgetId, QgsEditorWidgetFactory *widgetFactory)
 Register a new widget factory with the given id. More...
 

Static Public Member Functions

static void initEditors (QgsMapCanvas *mapCanvas=0, QgsMessageBar *messageBar=0)
 Registers all the default widgets. More...
 
static QgsEditorWidgetRegistryinstance ()
 This class is a singleton and has therefore to be accessed with this method instead of a constructor. More...
 

Protected Member Functions

 QgsEditorWidgetRegistry ()
 

Detailed Description

This class manages all known edit widget factories.

Definition at line 32 of file qgseditorwidgetregistry.h.

Constructor & Destructor Documentation

QgsEditorWidgetRegistry::~QgsEditorWidgetRegistry ( )

Destructor.

Deletes all the registered widgets

Definition at line 79 of file qgseditorwidgetregistry.cpp.

QgsEditorWidgetRegistry::QgsEditorWidgetRegistry ( )
protected

Definition at line 71 of file qgseditorwidgetregistry.cpp.

Member Function Documentation

QgsEditorWidgetWrapper * QgsEditorWidgetRegistry::create ( const QString &  widgetId,
QgsVectorLayer vl,
int  fieldIdx,
const QgsEditorWidgetConfig 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 NULL if you want the widget wrapper to create a default widget.

Parameters
widgetIdThe id of the widget type to create an attribute editor for
vlThe vector layer for which this widget will be created
fieldIdxThe field index on the specified layer for which this widget will be created
configA configuration which should be used for the widget creation
editorAn editor widget which will be used instead of an autocreated widget
parentThe parent which will be used for the created wrapper and the created widget
contextThe editor context (not available in python bindings)
Returns
A new widget wrapper

Definition at line 84 of file qgseditorwidgetregistry.cpp.

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

Creates a configuration widget.

Parameters
widgetIdThe id of the widget type to create a configuration widget for
vlThe vector layer for which this widget will be created
fieldIdxThe field index on the specified layer for which this widget will be created
parentThe parent widget for the created widget
Returns
A new configuration widget

Definition at line 103 of file qgseditorwidgetregistry.cpp.

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

Get access to all registered factories.

Returns
All ids and factories

Definition at line 122 of file qgseditorwidgetregistry.cpp.

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

Get a factory for the given widget type id.

Returns
A factory or Null if not existent

Definition at line 127 of file qgseditorwidgetregistry.cpp.

void QgsEditorWidgetRegistry::initEditors ( QgsMapCanvas mapCanvas = 0,
QgsMessageBar messageBar = 0 
)
static

Registers all the default widgets.

Only call this once on startup of an application.

Parameters
mapCanvasSpecify a map canvas with which the widgets (relation reference) work
messageBarSpecify a message bar on which messages by widgets will be shown while working with the map canvas
Note
Added in QGIS 2.8
Not required for plugins, the QGIS application does that already

Definition at line 50 of file qgseditorwidgetregistry.cpp.

QgsEditorWidgetRegistry * QgsEditorWidgetRegistry::instance ( )
static

This class is a singleton and has therefore to be accessed with this method instead of a constructor.

Returns
The one and only instance of the editor widget registry

Definition at line 44 of file qgseditorwidgetregistry.cpp.

QString QgsEditorWidgetRegistry::name ( const QString &  widgetId)

Get the human readable name for a widget type.

Parameters
widgetIdThe widget type to get the name for
Returns
A human readable name

Definition at line 112 of file qgseditorwidgetregistry.cpp.

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

Register a new widget factory with the given id.

Parameters
widgetIdThe id which will be used later to refer to this widget type
widgetFactoryThe factory which will create this widget type
Returns
true, if successful, false, if the widgetId is already in use or widgetFactory is NULL

Definition at line 132 of file qgseditorwidgetregistry.cpp.


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