QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
Public Member Functions | List of all members
QgsRelationReferenceFactory Class Reference

#include <qgsrelationreferencefactory.h>

Inheritance diagram for QgsRelationReferenceFactory:
Inheritance graph
[legend]

Public Member Functions

 QgsRelationReferenceFactory (const QString &name, QgsMapCanvas *canvas, QgsMessageBar *messageBar)
 
QgsEditorConfigWidgetconfigWidget (QgsVectorLayer *vl, int fieldIdx, QWidget *parent) const override
 Override this in your implementation. More...
 
QgsEditorWidgetWrappercreate (QgsVectorLayer *vl, int fieldIdx, QWidget *editor, QWidget *parent) const override
 Override this in your implementation. More...
 
QgsSearchWidgetWrappercreateSearchWidget (QgsVectorLayer *vl, int fieldIdx, QWidget *parent) const override
 By default a simple QgsFilterLineEdit is returned as search widget. More...
 
unsigned int fieldScore (const QgsVectorLayer *vl, int fieldIdx) const override
 This method allows disabling this editor widget type for a certain field. More...
 
QHash< const char *, int > supportedWidgetTypes () override
 Returns a list of widget types which this editor widget supports. More...
 
- Public Member Functions inherited from QgsEditorWidgetFactory
 QgsEditorWidgetFactory (const QString &name)
 Constructor. More...
 
virtual ~QgsEditorWidgetFactory ()=default
 
QString name ()
 Returns The human readable identifier name of this widget type. More...
 
bool supportsField (const QgsVectorLayer *vl, int fieldIdx)
 Check if this editor widget type supports a certain field. More...
 

Detailed Description

Note
not available in Python bindings

Definition at line 34 of file qgsrelationreferencefactory.h.

Constructor & Destructor Documentation

◆ QgsRelationReferenceFactory()

QgsRelationReferenceFactory::QgsRelationReferenceFactory ( const QString &  name,
QgsMapCanvas canvas,
QgsMessageBar messageBar 
)

Definition at line 28 of file qgsrelationreferencefactory.cpp.

Member Function Documentation

◆ configWidget()

QgsEditorConfigWidget * QgsRelationReferenceFactory::configWidget ( QgsVectorLayer vl,
int  fieldIdx,
QWidget *  parent 
) const
overridevirtual

Override this in your implementation.

Create a new configuration widget for this widget type.

Parameters
vlThe layer for which the widget will be created
fieldIdxThe field index for which the widget will be created
parentThe parent widget of the created config widget
Returns
A configuration widget

Implements QgsEditorWidgetFactory.

Definition at line 45 of file qgsrelationreferencefactory.cpp.

◆ create()

QgsEditorWidgetWrapper * QgsRelationReferenceFactory::create ( QgsVectorLayer vl,
int  fieldIdx,
QWidget *  editor,
QWidget *  parent 
) const
overridevirtual

Override this in your implementation.

Create a new editor widget wrapper. Call QgsEditorWidgetRegistry::create() instead of calling this method directly.

Parameters
vlThe vector layer on which this widget will act
fieldIdxThe field index on which this widget will act
editorAn editor widget if already existent. If nullptr is provided, a new widget will be created.
parentThe parent for the wrapper class and any created widget.
Returns
A new widget wrapper

Implements QgsEditorWidgetFactory.

Definition at line 35 of file qgsrelationreferencefactory.cpp.

◆ createSearchWidget()

QgsSearchWidgetWrapper * QgsRelationReferenceFactory::createSearchWidget ( QgsVectorLayer vl,
int  fieldIdx,
QWidget *  parent 
) const
overridevirtual

By default a simple QgsFilterLineEdit is returned as search widget.

Override in own factory to get something different than the default.

Reimplemented from QgsEditorWidgetFactory.

Definition at line 40 of file qgsrelationreferencefactory.cpp.

◆ fieldScore()

unsigned int QgsRelationReferenceFactory::fieldScore ( const QgsVectorLayer vl,
int  fieldIdx 
) const
overridevirtual

This method allows disabling this editor widget type for a certain field.

By default, it returns 5 for every fields. Reimplement this if you only support certain fields.

Typical return values are:

  • 0: not supported
  • 5: maybe support (for example, Datetime support strings depending on their content)
  • 10: basic support (this is what returns TextEdit for example, since it supports everything in a crude way)
  • 20: specialized support
Parameters
vl
fieldIdx
Returns
0 if the field is not supported or a bigger number if it can (the widget with the biggest number will be taken by default). The default implementation returns 5..
See also
supportsField()

Reimplemented from QgsEditorWidgetFactory.

Definition at line 57 of file qgsrelationreferencefactory.cpp.

◆ supportedWidgetTypes()

QHash< const char *, int > QgsRelationReferenceFactory::supportedWidgetTypes ( )
overridevirtual

Returns a list of widget types which this editor widget supports.

Each widget type can have a priority value attached, the factory with the highest one will be used.

Returns
A map of widget type names and weight values
Note
not available in Python bindings

Reimplemented from QgsEditorWidgetFactory.

Definition at line 50 of file qgsrelationreferencefactory.cpp.


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