A model which displays the list of fields in widgets (optionally associated with a vector layer). More...

#include <qgsfieldmodel.h>

Inheritance diagram for QgsFieldModel:

Public Types
enum class	CustomRole : int { FieldName = Qt::UserRole + 1 , FieldIndex = Qt::UserRole + 2 , Expression = Qt::UserRole + 3 , IsExpression = Qt::UserRole + 4 , ExpressionValidity = Qt::UserRole + 5 , FieldType = Qt::UserRole + 6 , FieldOrigin = Qt::UserRole + 7 , IsEmpty = Qt::UserRole + 8 , EditorWidgetType = Qt::UserRole + 9 , JoinedFieldIsEditable = Qt::UserRole + 10 , FieldIsWidgetEditable = Qt::UserRole + 11 }
	Custom model roles. More...

Public Slots
void	setLayer (QgsVectorLayer *layer)
	Set the layer from which fields are displayed.

Public Member Functions
	QgsFieldModel (QObject *parent=nullptr)
	Constructor for QgsFieldModel - creates a model to display the fields of a given layer.

bool	allowEmptyFieldName () const
	Returns `true` if the model allows the empty field ("not set") choice.

bool	allowExpression ()
	Returns `true` if the model allows custom expressions to be created and displayed.

int	columnCount (const QModelIndex &parent) const override

QVariant	data (const QModelIndex &index, int role) const override

QgsFields	fields () const
	Returns the fields currently shown in the model.

QModelIndex	index (int row, int column, const QModelIndex &parent=QModelIndex()) const override

QModelIndex	indexFromName (const QString &fieldName)
	Returns the index corresponding to a given fieldName.

bool	isField (const QString &expression) const
	Returns `true` if a string represents a field reference, or `false` if it is an expression consisting of more than direct field reference.

QgsVectorLayer *	layer ()
	Returns the layer associated with the model.

QModelIndex	parent (const QModelIndex &child) const override

void	removeExpression ()
	Removes any custom expression from the model.

int	rowCount (const QModelIndex &parent=QModelIndex()) const override

void	setAllowEmptyFieldName (bool allowEmpty)
	Sets whether an optional empty field ("not set") option is present in the model.

void	setAllowExpression (bool allowExpression)
	Sets whether custom expressions are accepted and displayed in the model.

void	setExpression (const QString &expression)
	Sets a single expression to be added after the fields at the end of the model.

void	setFields (const QgsFields &fields)
	Manually sets the fields to use for the model.

Static Public Member Functions
static QString	fieldToolTip (const QgsField &field)
	Returns a HTML formatted tooltip string for a field, containing details like the field name, alias and type.

static QString	fieldToolTipExtended (const QgsField &field, const QgsVectorLayer *layer)
	Returns a HTML formatted tooltip string for a field, containing details like the field name, alias, type and expression.

Protected Slots
virtual void	updateModel ()
	Called when the model must be updated.

Protected Attributes
bool	mAllowEmpty = false

bool	mAllowExpression = false

QList< QString >	mExpression

QgsFields	mFields

QgsVectorLayer *	mLayer = nullptr

Properties
bool	allowEmptyFieldName

bool	allowExpression

QgsVectorLayer *	layer

Detailed Description

A model which displays the list of fields in widgets (optionally associated with a vector layer).

If allowed, expressions might be added to the end of the model. It can be associated with a QgsMapLayerModel to dynamically display a layer and its fields.

Definition at line 38 of file qgsfieldmodel.h.

Member Enumeration Documentation

◆ CustomRole

enum class QgsFieldModel::CustomRole : int

strong

Custom model roles.

Note: Prior to QGIS 3.36 this was available as QgsFieldModel::FieldRoles

Since: QGIS 3.36

Enumerator
FieldName	Return field name if index corresponds to a field.
FieldIndex	Return field index if index corresponds to a field.
Expression	Return field name or expression.
IsExpression	Return if index corresponds to an expression.
ExpressionValidity	Return if expression is valid or not.
FieldType	Return the field type (if a field, return QVariant if expression)
FieldOrigin	Return the field origin (if a field, returns QVariant if expression)
IsEmpty	Return if the index corresponds to the empty value.
EditorWidgetType	Editor widget type.
JoinedFieldIsEditable	`true` if a joined field is editable (returns QVariant if not a joined field)
FieldIsWidgetEditable	`true` if a is editable from the widget

Definition at line 56 of file qgsfieldmodel.h.

Constructor & Destructor Documentation

◆ QgsFieldModel()

QgsFieldModel::QgsFieldModel ( QObject * parent = nullptr )

explicit

Constructor for QgsFieldModel - creates a model to display the fields of a given layer.

Definition at line 24 of file qgsfieldmodel.cpp.

Member Function Documentation

◆ allowEmptyFieldName()

bool QgsFieldModel::allowEmptyFieldName ( ) const

inline

Returns true if the model allows the empty field ("not set") choice.

See also: setAllowEmptyFieldName()

Definition at line 106 of file qgsfieldmodel.h.

◆ allowExpression()

bool QgsFieldModel::allowExpression ( )

inline

Returns true if the model allows custom expressions to be created and displayed.

See also: setAllowExpression()

Definition at line 94 of file qgsfieldmodel.h.

◆ columnCount()

int QgsFieldModel::columnCount ( const QModelIndex & parent ) const

override

Definition at line 264 of file qgsfieldmodel.cpp.

◆ data()

QVariant QgsFieldModel::data	(	const QModelIndex &	index,
		int	role
	)		const

override

Definition at line 270 of file qgsfieldmodel.cpp.

◆ fields()

QgsFields QgsFieldModel::fields ( ) const

Returns the fields currently shown in the model.

This will either be fields from the associated layer() or the fields manually set by a call to setFields().

Since: QGIS 3.14

Definition at line 526 of file qgsfieldmodel.cpp.

◆ fieldToolTip()

QString QgsFieldModel::fieldToolTip ( const QgsField & field )

static

Returns a HTML formatted tooltip string for a field, containing details like the field name, alias and type.

Definition at line 473 of file qgsfieldmodel.cpp.

◆ fieldToolTipExtended()

QString QgsFieldModel::fieldToolTipExtended	(	const QgsField &	field,
		const QgsVectorLayer *	layer
	)

static

Returns a HTML formatted tooltip string for a field, containing details like the field name, alias, type and expression.

Since: QGIS 3.14

Definition at line 497 of file qgsfieldmodel.cpp.

◆ index()

QModelIndex QgsFieldModel::index	(	int	row,
		int	column,
		const QModelIndex &	parent = `QModelIndex()`
	)		const

override

Definition at line 238 of file qgsfieldmodel.cpp.

◆ indexFromName()

QModelIndex QgsFieldModel::indexFromName ( const QString & fieldName )

Returns the index corresponding to a given fieldName.

Definition at line 29 of file qgsfieldmodel.cpp.

◆ isField()

bool QgsFieldModel::isField ( const QString & expression ) const

Returns true if a string represents a field reference, or false if it is an expression consisting of more than direct field reference.

Definition at line 74 of file qgsfieldmodel.cpp.

◆ layer()

QgsVectorLayer * QgsFieldModel::layer ( )

inline

Returns the layer associated with the model.

See also: setLayer()

Definition at line 133 of file qgsfieldmodel.h.

◆ parent()

QModelIndex QgsFieldModel::parent ( const QModelIndex & child ) const

override

Definition at line 248 of file qgsfieldmodel.cpp.

◆ removeExpression()

void QgsFieldModel::removeExpression ( )

Removes any custom expression from the model.

See also: setExpression(); allowExpression()

Definition at line 231 of file qgsfieldmodel.cpp.

◆ rowCount()

int QgsFieldModel::rowCount ( const QModelIndex & parent = QModelIndex() ) const

override

Definition at line 254 of file qgsfieldmodel.cpp.

◆ setAllowEmptyFieldName()

void QgsFieldModel::setAllowEmptyFieldName ( bool allowEmpty )

Sets whether an optional empty field ("not set") option is present in the model.

See also: allowEmptyFieldName()

Definition at line 195 of file qgsfieldmodel.cpp.

◆ setAllowExpression()

void QgsFieldModel::setAllowExpression ( bool allowExpression )

Sets whether custom expressions are accepted and displayed in the model.

See also: allowExpression(); setExpression()

Definition at line 178 of file qgsfieldmodel.cpp.

◆ setExpression()

void QgsFieldModel::setExpression ( const QString & expression )

Sets a single expression to be added after the fields at the end of the model.

See also: setAllowExpression(); allowExpression(); removeExpression()

Definition at line 215 of file qgsfieldmodel.cpp.

◆ setFields()

void QgsFieldModel::setFields ( const QgsFields & fields )

Manually sets the fields to use for the model.

This method should only be used when the model ISN'T associated with a layer() and needs to show the fields from an arbitrary field collection instead. Calling setFields() will automatically clear any existing layer().

See also: fields()

Since: QGIS 3.14

Definition at line 518 of file qgsfieldmodel.cpp.

◆ setLayer

void QgsFieldModel::setLayer ( QgsVectorLayer * layer )

slot

Set the layer from which fields are displayed.

See also: layer()

Definition at line 80 of file qgsfieldmodel.cpp.

◆ updateModel

void QgsFieldModel::updateModel ( )

protectedvirtualslot

Called when the model must be updated.

Definition at line 105 of file qgsfieldmodel.cpp.

Member Data Documentation

◆ mAllowEmpty

bool QgsFieldModel::mAllowEmpty = false

protected

Definition at line 201 of file qgsfieldmodel.h.

◆ mAllowExpression

bool QgsFieldModel::mAllowExpression = false

protected

Definition at line 200 of file qgsfieldmodel.h.

◆ mExpression

QList<QString> QgsFieldModel::mExpression

protected

Definition at line 197 of file qgsfieldmodel.h.

◆ mFields

QgsFields QgsFieldModel::mFields

protected

Definition at line 196 of file qgsfieldmodel.h.

◆ mLayer

QgsVectorLayer* QgsFieldModel::mLayer = nullptr

protected

Definition at line 199 of file qgsfieldmodel.h.

Property Documentation

◆ allowEmptyFieldName

bool QgsFieldModel::allowEmptyFieldName

readwrite

Definition at line 43 of file qgsfieldmodel.h.

◆ allowExpression

bool QgsFieldModel::allowExpression

readwrite

Definition at line 42 of file qgsfieldmodel.h.

◆ layer

QgsVectorLayer * QgsFieldModel::layer

readwrite

Definition at line 44 of file qgsfieldmodel.h.

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

/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/qgsfieldmodel.h
/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/qgsfieldmodel.cpp

Public Types

Public Slots

Public Member Functions

Static Public Member Functions

Protected Slots

Protected Attributes

Properties

Detailed Description

Member Enumeration Documentation

◆ CustomRole

Constructor & Destructor Documentation

◆ QgsFieldModel()

Member Function Documentation

◆ allowEmptyFieldName()

◆ allowExpression()

◆ columnCount()

◆ data()

◆ fields()

◆ fieldToolTip()

◆ fieldToolTipExtended()

◆ index()

◆ indexFromName()

◆ isField()

◆ layer()

◆ parent()

◆ removeExpression()

◆ rowCount()

◆ setAllowEmptyFieldName()

◆ setAllowExpression()

◆ setExpression()

◆ setFields()

◆ setLayer

◆ updateModel

Member Data Documentation

◆ mAllowEmpty

◆ mAllowExpression

◆ mExpression

◆ mFields

◆ mLayer

Property Documentation

◆ allowEmptyFieldName

◆ allowExpression

◆ layer