A field formatter helps to handle and display values for a field. More...

#include <qgsfieldformatter.h>

Inheritance diagram for QgsFieldFormatter:

[legend]

Public Types
typedef QFlags< Flag >	Flags

Public Member Functions
	QgsFieldFormatter ()=default

virtual	~QgsFieldFormatter ()=default

virtual Qt::AlignmentFlag	alignmentFlag (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Returns the alignment for a particular field.

virtual QVariantList	availableValues (const QVariantMap &config, int countLimit, const QgsFieldFormatterContext &context) const
	Returns a list of the values that would be possible to select with this widget type On a RelationReference that would be the parents ids or on ValueMap all the configured keys according to the settings in the config.

virtual QVariant	createCache (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Create a cache for a given field.

Flags	flags () const
	Returns the flags.

virtual QString	id () const =0
	Returns a unique id for this field formatter.

virtual QList< QgsVectorLayerRef >	layerDependencies (const QVariantMap &config) const SIP_SKIP
	Returns a list of weak layer references to other layers required by this formatter for the given config.

virtual QString	representValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config, const QVariant &cache, const QVariant &value) const
	Create a pretty String representation of the value.

void	setFlags (const Flags &flags)
	Sets the flags.

enum Flag	SIP_ENUM_BASETYPE (IntFlag)
	Flags for the abilities of the formatter.

virtual QVariant	sortValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &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.

Detailed Description

A field formatter helps to handle and display values for a field.

It allows for using a shared configuration with the editor widgets for representation of attribute values. Field kits normally have one single instance which is managed by the QgsFieldFormatterRegistry. Custom field formatters should be registered there and field formatters for use within code should normally be obtained from there.

This is an abstract base class and will always need to be subclassed.

Definition at line 68 of file qgsfieldformatter.h.

Member Typedef Documentation

◆ Flags

typedef QFlags< Flag > QgsFieldFormatter::Flags

Definition at line 85 of file qgsfieldformatter.h.

Constructor & Destructor Documentation

◆ QgsFieldFormatter()

QgsFieldFormatter::QgsFieldFormatter ( )

default

◆ ~QgsFieldFormatter()

virtual QgsFieldFormatter::~QgsFieldFormatter ( )

virtualdefault

Member Function Documentation

◆ alignmentFlag()

Qt::AlignmentFlag QgsFieldFormatter::alignmentFlag	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config
	)		const

virtual

Returns the alignment for a particular field.

By default this will consider the field type but can be overwritten if mapped values are represented.

Definition at line 60 of file qgsfieldformatter.cpp.

◆ availableValues()

QVariantList QgsFieldFormatter::availableValues	(	const QVariantMap &	config,
		int	countLimit,
		const QgsFieldFormatterContext &	context
	)		const

virtual

Returns a list of the values that would be possible to select with this widget type On a RelationReference that would be the parents ids or on ValueMap all the configured keys according to the settings in the config.

Since: QGIS 3.12

Reimplemented in QgsRelationReferenceFieldFormatter, QgsValueMapFieldFormatter, and QgsValueRelationFieldFormatter.

Definition at line 86 of file qgsfieldformatter.cpp.

◆ createCache()

QVariant QgsFieldFormatter::createCache	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config
	)		const

virtual

Create a cache for a given field.

This will be used in situations where a field is being represented various times in a loop. And will be passed to other methods on QgsFieldKit and QgsEditorWidgetWrapper.

For example, the attribute table will create a cache once for each field and then use this cache for representation. The QgsValueRelationFieldFormatter and QgsValueRelationEditorWidget implement this functionality to create a lookuptable once (a QVariantMap / dict) and are make use of a cache if present.

Reimplemented in QgsRelationReferenceFieldFormatter, and QgsValueRelationFieldFormatter.

Definition at line 71 of file qgsfieldformatter.cpp.

◆ flags()

Flags QgsFieldFormatter::flags ( ) const

inline

Returns the flags.

Since: QGIS 3.12

Definition at line 159 of file qgsfieldformatter.h.

◆ id()

virtual QString QgsFieldFormatter::id ( ) const

pure virtual

Returns a unique id for this field formatter.

This id will later be used to identify this field formatter in the registry with QgsFieldFormatterRegistry::fieldFormatter().

This id matches the id of a QgsEditorWidgetFactory.

Implemented in QgsCheckBoxFieldFormatter, QgsDateTimeFieldFormatter, QgsFallbackFieldFormatter, QgsKeyValueFieldFormatter, QgsListFieldFormatter, QgsRangeFieldFormatter, QgsRelationReferenceFieldFormatter, QgsValueMapFieldFormatter, and QgsValueRelationFieldFormatter.

◆ layerDependencies()

QList< QgsVectorLayerRef > QgsFieldFormatter::layerDependencies ( const QVariantMap & config ) const

virtual

Returns a list of weak layer references to other layers required by this formatter for the given config.

The default implementation returns an empty list.

This method should be reimplemented by formatters that handle relations with other layers, (e.g. ValueRelation) and can be used by client code to warn the user about missing required dependencies or to add some resolution logic in order to load the missing dependency.

Note: not available in Python bindings

Since: QGIS 3.12

Reimplemented in QgsValueRelationFieldFormatter, and QgsRelationReferenceFieldFormatter.

Definition at line 80 of file qgsfieldformatter.cpp.

◆ representValue()

QString QgsFieldFormatter::representValue	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config,
		const QVariant &	cache,
		const QVariant &	value
	)		const

virtual

Create a pretty String representation of the value.

Returns: By default the string representation of the provided value as implied by the field definition is returned.

Reimplemented in QgsCheckBoxFieldFormatter, QgsDateTimeFieldFormatter, QgsKeyValueFieldFormatter, QgsListFieldFormatter, QgsRangeFieldFormatter, QgsRelationReferenceFieldFormatter, QgsValueMapFieldFormatter, and QgsValueRelationFieldFormatter.

Definition at line 24 of file qgsfieldformatter.cpp.

◆ setFlags()

void QgsFieldFormatter::setFlags ( const Flags & flags )

Sets the flags.

Since: QGIS 3.12

Definition at line 95 of file qgsfieldformatter.cpp.

◆ SIP_ENUM_BASETYPE()

enum Flag QgsFieldFormatter::SIP_ENUM_BASETYPE ( IntFlag )

inline

Flags for the abilities of the formatter.

Since: QGIS 3.12

< Can provide possible values

Definition at line 81 of file qgsfieldformatter.h.

◆ sortValue()

QVariant QgsFieldFormatter::sortValue	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config,
		const QVariant &	cache,
		const QVariant &	value
	)		const

virtual

If the default sort order should be overwritten for this widget, you can transform the value in here.

Returns: an unmodified value by default.

Reimplemented in QgsRelationReferenceFieldFormatter, QgsValueMapFieldFormatter, and QgsValueRelationFieldFormatter.

Definition at line 50 of file qgsfieldformatter.cpp.

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

/build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/core/qgsfieldformatter.h
/build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/core/qgsfieldformatter.cpp

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ Flags

Constructor & Destructor Documentation

◆ QgsFieldFormatter()

◆ ~QgsFieldFormatter()

Member Function Documentation

◆ alignmentFlag()

◆ availableValues()

◆ createCache()

◆ flags()

◆ id()

◆ layerDependencies()

◆ representValue()

◆ setFlags()

◆ SIP_ENUM_BASETYPE()

◆ sortValue()