The QgsFieldMappingModel holds mapping information for mapping from one set of QgsFields to another, for each set of "destination" fields an expression defines how to obtain the values of the "destination" fields. More...

#include <qgsfieldmappingmodel.h>

Inheritance diagram for QgsFieldMappingModel:

[legend]

Classes
struct	Field
	The Field struct holds information about a mapped field. More...

Public Types
enum class	ColumnDataIndex : int { SourceExpression , DestinationName , DestinationType , DestinationLength , DestinationPrecision , DestinationConstraints , DestinationAlias , DestinationComment }
	The ColumnDataIndex enum represents the column index for the view. More...

Public Member Functions
	QgsFieldMappingModel (const QgsFields &sourceFields=QgsFields(), const QgsFields &destinationFields=QgsFields(), const QMap< QString, QString > &expressions=QMap< QString, QString >(), QObject *parent=nullptr)
	Constructs a QgsFieldMappingModel from a set of sourceFields and destinationFields, initial values for the expressions can be optionally specified through expressions which is a map from the original field name to the corresponding expression. More...

void	appendField (const QgsField &field, const QString &expression=QString())
	Appends a new field to the model, with an optional expression. More...

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

QgsExpressionContextGenerator *	contextGenerator () const
	Returns the context generator with the source fields. More...

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

bool	destinationEditable () const
	Returns `true` if the destination fields are editable. More...

QMap< QString, QgsProperty >	fieldPropertyMap () const
	Returns a map of destination field name to QgsProperty definition for field value, representing the current status of the model. More...

Qt::ItemFlags	flags (const QModelIndex &index) const override

QVariant	headerData (int section, Qt::Orientation orientation, int role) const override

QList< QgsFieldMappingModel::Field >	mapping () const
	Returns a list of Field objects representing the current status of the model. More...

bool	moveDown (const QModelIndex &index)
	Moves up the field at index. More...

bool	moveUp (const QModelIndex &index)
	Moves down the field at index. More...

	Q_ENUM (ColumnDataIndex)

bool	removeField (const QModelIndex &index)
	Removes the field at index from the model, returns `true` on success. More...

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

void	setBaseExpressionContextGenerator (const QgsExpressionContextGenerator *generator)
	Sets the base expression context generator, which will generate the expression contexts for expression based widgets used by the model. More...

bool	setData (const QModelIndex &index, const QVariant &value, int role) override

void	setDestinationEditable (bool editable)
	Sets the destination fields editable state to editable. More...

void	setDestinationFields (const QgsFields &destinationFields, const QMap< QString, QString > &expressions=QMap< QString, QString >())
	Set destination fields to destinationFields, initial values for the expressions can be optionally specified through expressions which is a map from the original field name to the corresponding expression. More...

void	setFieldPropertyMap (const QMap< QString, QgsProperty > &map)
	Sets a map of destination field name to QgsProperty definition for field value. More...

void	setSourceFields (const QgsFields &sourceFields)
	Set source fields to sourceFields. More...

QgsFields	sourceFields () const
	Returns a list of source fields. More...

Static Public Member Functions
static Q_DECL_DEPRECATED const QMap< QVariant::Type, QString >	dataTypes ()
	Returns a static map of supported data types. More...

static const QList< QgsVectorDataProvider::NativeType >	supportedDataTypes ()
	Returns a static list of supported data types. More...

Friends
class	QgsAggregateMappingModel

Detailed Description

The QgsFieldMappingModel holds mapping information for mapping from one set of QgsFields to another, for each set of "destination" fields an expression defines how to obtain the values of the "destination" fields.

The model can be optionally set "editable" allowing to modify all the fields, by default only the mapping expression is editable.

Since: QGIS 3.14

Definition at line 40 of file qgsfieldmappingmodel.h.

Member Enumeration Documentation

◆ ColumnDataIndex

enum class QgsFieldMappingModel::ColumnDataIndex : int

strong

The ColumnDataIndex enum represents the column index for the view.

Enumerator
SourceExpression	Expression.
DestinationName	Destination field name.
DestinationType	Destination field type string.
DestinationLength	Destination field length.
DestinationPrecision	Destination field precision.
DestinationConstraints	Destination field constraints.
DestinationAlias	Destination alias.
DestinationComment	Destination comment.

Definition at line 50 of file qgsfieldmappingmodel.h.

Constructor & Destructor Documentation

◆ QgsFieldMappingModel()

QgsFieldMappingModel::QgsFieldMappingModel	(	const QgsFields &	sourceFields = `QgsFields()`,
		const QgsFields &	destinationFields = `QgsFields()`,
		const QMap< QString, QString > &	expressions = `QMap<QString, QString>()`,
		QObject *	parent = `nullptr`
	)

Constructs a QgsFieldMappingModel from a set of sourceFields and destinationFields, initial values for the expressions can be optionally specified through expressions which is a map from the original field name to the corresponding expression.

A parent object can be also specified.

Definition at line 22 of file qgsfieldmappingmodel.cpp.

Member Function Documentation

◆ appendField()

void QgsFieldMappingModel::appendField	(	const QgsField &	field,
		const QString &	expression = `QString()`
	)

Appends a new field to the model, with an optional expression.

Definition at line 535 of file qgsfieldmappingmodel.cpp.

◆ columnCount()

int QgsFieldMappingModel::columnCount ( const QModelIndex & parent = QModelIndex() ) const

override

Definition at line 99 of file qgsfieldmappingmodel.cpp.

◆ contextGenerator()

QgsExpressionContextGenerator * QgsFieldMappingModel::contextGenerator ( ) const

Returns the context generator with the source fields.

Definition at line 361 of file qgsfieldmappingmodel.cpp.

◆ data()

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

override

Definition at line 106 of file qgsfieldmappingmodel.cpp.

◆ dataTypes()

const QMap< QVariant::Type, QString > QgsFieldMappingModel::dataTypes ( )

static

Returns a static map of supported data types.

Deprecated:: QGIS 3.24 use supportedDataTypes() instead

Definition at line 416 of file qgsfieldmappingmodel.cpp.

◆ destinationEditable()

bool QgsFieldMappingModel::destinationEditable ( ) const

Returns true if the destination fields are editable.

Definition at line 406 of file qgsfieldmappingmodel.cpp.

◆ fieldPropertyMap()

QMap< QString, QgsProperty > QgsFieldMappingModel::fieldPropertyMap ( ) const

Returns a map of destination field name to QgsProperty definition for field value, representing the current status of the model.

See also: setFieldPropertyMap()

Definition at line 485 of file qgsfieldmappingmodel.cpp.

◆ flags()

Qt::ItemFlags QgsFieldMappingModel::flags ( const QModelIndex & index ) const

override

Definition at line 192 of file qgsfieldmappingmodel.cpp.

◆ headerData()

QVariant QgsFieldMappingModel::headerData	(	int	section,
		Qt::Orientation	orientation,
		int	role
	)		const

override

Definition at line 33 of file qgsfieldmappingmodel.cpp.

◆ mapping()

QList< QgsFieldMappingModel::Field > QgsFieldMappingModel::mapping ( ) const

Returns a list of Field objects representing the current status of the model.

Definition at line 480 of file qgsfieldmappingmodel.cpp.

◆ moveDown()

bool QgsFieldMappingModel::moveDown ( const QModelIndex & index )

Moves up the field at index.

Definition at line 568 of file qgsfieldmappingmodel.cpp.

◆ moveUp()

bool QgsFieldMappingModel::moveUp ( const QModelIndex & index )

Moves down the field at index.

Definition at line 563 of file qgsfieldmappingmodel.cpp.

◆ Q_ENUM()

QgsFieldMappingModel::Q_ENUM ( ColumnDataIndex )

◆ removeField()

bool QgsFieldMappingModel::removeField ( const QModelIndex & index )

Removes the field at index from the model, returns true on success.

Definition at line 548 of file qgsfieldmappingmodel.cpp.

◆ rowCount()

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

override

Definition at line 92 of file qgsfieldmappingmodel.cpp.

◆ setBaseExpressionContextGenerator()

void QgsFieldMappingModel::setBaseExpressionContextGenerator ( const QgsExpressionContextGenerator * generator )

Sets the base expression context generator, which will generate the expression contexts for expression based widgets used by the model.

Definition at line 366 of file qgsfieldmappingmodel.cpp.

◆ setData()

bool QgsFieldMappingModel::setData	(	const QModelIndex &	index,
		const QVariant &	value,
		int	role
	)

override

Definition at line 205 of file qgsfieldmappingmodel.cpp.

◆ setDestinationEditable()

void QgsFieldMappingModel::setDestinationEditable ( bool editable )

Sets the destination fields editable state to editable.

Definition at line 411 of file qgsfieldmappingmodel.cpp.

◆ setDestinationFields()

void QgsFieldMappingModel::setDestinationFields	(	const QgsFields &	destinationFields,
		const QMap< QString, QString > &	expressions = `QMap<QString, QString>()`
	)

Set destination fields to destinationFields, initial values for the expressions can be optionally specified through expressions which is a map from the original field name to the corresponding expression.

Definition at line 371 of file qgsfieldmappingmodel.cpp.

◆ setFieldPropertyMap()

void QgsFieldMappingModel::setFieldPropertyMap ( const QMap< QString, QgsProperty > & map )

Sets a map of destination field name to QgsProperty definition for field value.

See also: fieldPropertyMap()

Definition at line 499 of file qgsfieldmappingmodel.cpp.

◆ setSourceFields()

void QgsFieldMappingModel::setSourceFields ( const QgsFields & sourceFields )

Set source fields to sourceFields.

Definition at line 335 of file qgsfieldmappingmodel.cpp.

◆ sourceFields()

QgsFields QgsFieldMappingModel::sourceFields ( ) const

Returns a list of source fields.

Definition at line 87 of file qgsfieldmappingmodel.cpp.

◆ supportedDataTypes()

const QList< QgsVectorDataProvider::NativeType > QgsFieldMappingModel::supportedDataTypes ( )

static

Returns a static list of supported data types.

Since: QGIS 3.24

Definition at line 433 of file qgsfieldmappingmodel.cpp.

Friends And Related Function Documentation

◆ QgsAggregateMappingModel

friend class QgsAggregateMappingModel

friend

Definition at line 224 of file qgsfieldmappingmodel.h.

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

/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/gui/qgsfieldmappingmodel.h
/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/gui/qgsfieldmappingmodel.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ ColumnDataIndex

Constructor & Destructor Documentation

◆ QgsFieldMappingModel()

Member Function Documentation

◆ appendField()

◆ columnCount()

◆ contextGenerator()

◆ data()

◆ dataTypes()

◆ destinationEditable()

◆ fieldPropertyMap()

◆ flags()

◆ headerData()

◆ mapping()

◆ moveDown()

◆ moveUp()

◆ Q_ENUM()

◆ removeField()

◆ rowCount()

◆ setBaseExpressionContextGenerator()

◆ setData()

◆ setDestinationEditable()

◆ setDestinationFields()

◆ setFieldPropertyMap()

◆ setSourceFields()

◆ sourceFields()

◆ supportedDataTypes()

Friends And Related Function Documentation

◆ QgsAggregateMappingModel