QGIS API Documentation  2.99.0-Master (c42dad3)
Public Member Functions | List of all members
QgsTextEditWidgetFactory Class Reference

#include <qgstexteditwidgetfactory.h>

Inheritance diagram for QgsTextEditWidgetFactory:
Inheritance graph
[legend]

Public Member Functions

 QgsTextEditWidgetFactory (const QString &name)
 
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...
 
void writeConfig (const QgsEditorWidgetConfig &config, QDomElement &configElement, QDomDocument &doc, const QgsVectorLayer *layer, int fieldIdx) override
 Serialize your configuration and save it in a xml doc. More...
 
- Public Member Functions inherited from QgsEditorWidgetFactory
 QgsEditorWidgetFactory (const QString &name)
 Constructor. More...
 
virtual ~QgsEditorWidgetFactory ()
 
virtual Qt::AlignmentFlag alignmentFlag (QgsVectorLayer *vl, int fieldIdx, const QgsEditorWidgetConfig &config) const
 Return the alignment for a particular field. More...
 
virtual QVariant createCache (QgsVectorLayer *vl, int fieldIdx, const QgsEditorWidgetConfig &config)
 Create a cache for a given field. More...
 
QString name ()
 Return The human readable identifier name of this widget type. More...
 
QgsEditorWidgetConfig readEditorConfig (const QDomElement &configElement, QgsVectorLayer *layer, int fieldIdx)
 Read the config from an XML file and map it to a proper QgsEditorWidgetConfig. More...
 
virtual QString representValue (QgsVectorLayer *vl, int fieldIdx, const QgsEditorWidgetConfig &config, const QVariant &cache, const QVariant &value) const
 Create a pretty String representation of the value. More...
 
virtual QVariant sortValue (QgsVectorLayer *vl, int fieldIdx, const QgsEditorWidgetConfig &config, const QVariant &cache, const QVariant &value) const
 If the default sort order should be overwritten for this widget, you can transform the value in here. More...
 
virtual QHash< const char *, int > supportedWidgetTypes ()
 Returns a list of widget types which this editor widget supports. More...
 
bool supportsField (const QgsVectorLayer *vl, int fieldIdx)
 Check if this editor widget type supports a certain field. More...
 

Additional Inherited Members

- Static Protected Member Functions inherited from QgsEditorWidgetFactory
static void config2xml (const QgsEditorWidgetConfig &config, QDomElement &configElement, const QString &fieldName)
 Copy the given config element to a XML attribute. More...
 
static void xml2config (const QDomElement &configElement, QgsEditorWidgetConfig &config, const QString &fieldName)
 Copy the given XML attribute to the configuration element. More...
 

Detailed Description

Note
not available in Python bindings

Definition at line 26 of file qgstexteditwidgetfactory.h.

Constructor & Destructor Documentation

§ QgsTextEditWidgetFactory()

QgsTextEditWidgetFactory::QgsTextEditWidgetFactory ( const QString &  name)

Definition at line 22 of file qgstexteditwidgetfactory.cpp.

Member Function Documentation

§ configWidget()

QgsEditorConfigWidget * QgsTextEditWidgetFactory::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 37 of file qgstexteditwidgetfactory.cpp.

§ create()

QgsEditorWidgetWrapper * QgsTextEditWidgetFactory::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 NULL 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 27 of file qgstexteditwidgetfactory.cpp.

§ createSearchWidget()

QgsSearchWidgetWrapper * QgsTextEditWidgetFactory::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 32 of file qgstexteditwidgetfactory.cpp.

§ fieldScore()

unsigned int QgsTextEditWidgetFactory::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: specialised 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( QgsVectorLayer* vl, fieldIdx )

Reimplemented from QgsEditorWidgetFactory.

Definition at line 66 of file qgstexteditwidgetfactory.cpp.

§ writeConfig()

void QgsTextEditWidgetFactory::writeConfig ( const QgsEditorWidgetConfig config,
QDomElement &  configElement,
QDomDocument &  doc,
const QgsVectorLayer layer,
int  fieldIdx 
)
overridevirtual

Serialize your configuration and save it in a xml doc.

Parameters
configThe configuration to serialize
configElementThe element, where you can write your configuration into
docThe document. You can use this to create new nodes
layerThe layer for which this configuration applies
fieldIdxThe field on the layer for which this configuration applies

Reimplemented from QgsEditorWidgetFactory.

Definition at line 43 of file qgstexteditwidgetfactory.cpp.


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