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 }
	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 const QMap< QVariant::Type, QString >	dataTypes ()
	Returns a static map 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 39 of file qgsfieldmappingmodel.h.

Member Enumeration Documentation

◆ ColumnDataIndex

enum QgsFieldMappingModel::ColumnDataIndex : int

strong

The ColumnDataIndex enum represents the column index for the view.

Enumerator
SourceExpression	Expression.
DestinationName	Destination field name.
DestinationType	Destination field QVariant::Type casted to (int)
DestinationLength	Destination field length.
DestinationPrecision	Destination field precision.
DestinationConstraints	Destination field constraints.

Definition at line 49 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 21 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 462 of file qgsfieldmappingmodel.cpp.

◆ columnCount()

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

override

Definition at line 90 of file qgsfieldmappingmodel.cpp.

◆ contextGenerator()

QgsExpressionContextGenerator * QgsFieldMappingModel::contextGenerator ( ) const

Returns the context generator with the source fields.

Definition at line 336 of file qgsfieldmappingmodel.cpp.

◆ data()

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

override

Definition at line 97 of file qgsfieldmappingmodel.cpp.

◆ dataTypes()

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

static

Returns a static map of supported data types.

Definition at line 390 of file qgsfieldmappingmodel.cpp.

◆ destinationEditable()

bool QgsFieldMappingModel::destinationEditable ( ) const

Returns true if the destination fields are editable.

Definition at line 380 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 412 of file qgsfieldmappingmodel.cpp.

◆ flags()

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

override

Definition at line 175 of file qgsfieldmappingmodel.cpp.

◆ headerData()

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

override

Definition at line 32 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 407 of file qgsfieldmappingmodel.cpp.

◆ moveDown()

bool QgsFieldMappingModel::moveDown ( const QModelIndex & index )

Moves up the field at index.

Definition at line 494 of file qgsfieldmappingmodel.cpp.

◆ moveUp()

bool QgsFieldMappingModel::moveUp ( const QModelIndex & index )

Moves down the field at index.

Definition at line 489 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 474 of file qgsfieldmappingmodel.cpp.

◆ rowCount()

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

override

Definition at line 83 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 341 of file qgsfieldmappingmodel.cpp.

◆ setData()

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

override

Definition at line 188 of file qgsfieldmappingmodel.cpp.

◆ setDestinationEditable()

void QgsFieldMappingModel::setDestinationEditable ( bool editable )

Sets the destination fields editable state to editable.

Definition at line 385 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 346 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 426 of file qgsfieldmappingmodel.cpp.

◆ setSourceFields()

void QgsFieldMappingModel::setSourceFields ( const QgsFields & sourceFields )

Set source fields to sourceFields.

Definition at line 310 of file qgsfieldmappingmodel.cpp.

◆ sourceFields()

QgsFields QgsFieldMappingModel::sourceFields ( ) const

Returns a list of source fields.

Definition at line 78 of file qgsfieldmappingmodel.cpp.

Friends And Related Function Documentation

◆ QgsAggregateMappingModel

friend class QgsAggregateMappingModel

friend

Definition at line 199 of file qgsfieldmappingmodel.h.

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

/build/qgis-3.22.4+99unstable/src/gui/qgsfieldmappingmodel.h
/build/qgis-3.22.4+99unstable/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()

Friends And Related Function Documentation

◆ QgsAggregateMappingModel