A model backed by a QgsVectorLayerCache which is able to provide feature/attribute information to a QAbstractItemView. More...

#include <qgsattributetablemodel.h>

Inheritance diagram for QgsAttributeTableModel:

[legend]

Public Types
enum	Role { SortRole = Qt::UserRole + 1, FeatureIdRole, FieldIndexRole, UserRole }

Public Slots
void	fieldConditionalStyleChanged (const QString &fieldName)
	Handles updating the model when the conditional style for a field changes. More...

virtual void	loadLayer ()
	Loads the layer into the model Preferably to be called, before using this model as source for any other proxy model. More...

Signals
void	finished ()

void	modelChanged ()
	Model has been changed. More...

void	progress (int i, bool &cancel)

Public Member Functions
	QgsAttributeTableModel (QgsVectorLayerCache layerCache, QObject parent=nullptr)
	Constructor. More...

int	columnCount (const QModelIndex &parent=QModelIndex()) const override
	Returns the number of columns. More...

QVariant	data (const QModelIndex &index, int role) const override
	Returns data on the given index. More...

const QgsAttributeEditorContext &	editorContext () const
	Returns the context in which this table is shown. More...

void	executeAction (QUuid action, const QModelIndex &idx) const
	Execute an action. More...

void	executeMapLayerAction (QgsMapLayerAction *action, const QModelIndex &idx) const
	Execute a QgsMapLayerAction. More...

int	extraColumns () const
	Empty extra columns to announce from this model. More...

QgsFeature	feature (const QModelIndex &idx) const
	Return the feature attributes at given model index. More...

int	fieldCol (int idx) const
	get column from field index More...

int	fieldIdx (int col) const
	get field index from column More...

Qt::ItemFlags	flags (const QModelIndex &index) const override
	Returns item flags for the index. More...

QVariant	headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const override
	Returns header data. More...

QModelIndex	idToIndex (QgsFeatureId id) const

QModelIndexList	idToIndexList (QgsFeatureId id) const

int	idToRow (QgsFeatureId id) const
	Maps feature id to table row. More...

QgsVectorLayer *	layer () const
	Returns the layer this model uses as backend. More...

QgsVectorLayerCache *	layerCache () const
	Returns the layer cache this model uses as backend. More...

void	prefetchColumnData (int column)
	Caches the entire data for one column. More...

void	prefetchSortData (const QString &expression)
	Prefetches the entire data for one expression. More...

void	reload (const QModelIndex &index1, const QModelIndex &index2)
	Reloads the model data between indices. More...

bool	removeRows (int row, int count, const QModelIndex &parent=QModelIndex()) override
	Remove rows. More...

const QgsFeatureRequest &	request () const
	Get the the feature request. More...

void	resetModel ()
	Resets the model. More...

int	rowCount (const QModelIndex &parent=QModelIndex()) const override
	Returns the number of rows. More...

QgsFeatureId	rowToId (int row) const
	Maps row to feature id. More...

bool	setData (const QModelIndex &index, const QVariant &value, int role=Qt::EditRole) override
	Updates data on given index. More...

void	setEditorContext (const QgsAttributeEditorContext &context)
	Sets the context in which this table is shown. More...

void	setExtraColumns (int extraColumns)
	Empty extra columns to announce from this model. More...

void	setRequest (const QgsFeatureRequest &request)
	Set a request that will be used to fill this attribute table model. More...

QString	sortCacheExpression () const
	The expression which was used to fill the sorting cache. More...

void	swapRows (QgsFeatureId a, QgsFeatureId b)
	Swaps two rows. More...

Friends
class	TestQgsAttributeTable

Detailed Description

A model backed by a QgsVectorLayerCache which is able to provide feature/attribute information to a QAbstractItemView.

Is able to generate editor widgets for its QModelIndexes as well. Is mostly referred to as "master model" within this doc and the source.

See also: Qt Model View Programming

Definition at line 50 of file qgsattributetablemodel.h.

Member Enumeration Documentation

◆ Role

enum QgsAttributeTableModel::Role

Enumerator
SortRole	Role used for sorting.
FeatureIdRole	Get the feature id of the feature in this row.
FieldIndexRole	Get the field index of this column.
UserRole	Start further roles starting from this role.

Definition at line 55 of file qgsattributetablemodel.h.

Constructor & Destructor Documentation

◆ QgsAttributeTableModel()

QgsAttributeTableModel::QgsAttributeTableModel	(	QgsVectorLayerCache *	layerCache,
		QObject *	parent = `nullptr`
	)

Constructor.

Parameters

layerCache	A layer cache to use as backend
parent	The parent QObject (owner)

Definition at line 46 of file qgsattributetablemodel.cpp.

Member Function Documentation

◆ columnCount()

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

override

Returns the number of columns.

Parameters

parent parent index

Definition at line 552 of file qgsattributetablemodel.cpp.

◆ data()

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

override

Returns data on the given index.

Parameters

index	model index
role	data role

Definition at line 598 of file qgsattributetablemodel.cpp.

◆ editorContext()

const QgsAttributeEditorContext& QgsAttributeTableModel::editorContext ( ) const

inline

Returns the context in which this table is shown.

Will be forwarded to any editor widget created when editing data on this model.

Returns: The context

Definition at line 242 of file qgsattributetablemodel.h.

◆ executeAction()

void QgsAttributeTableModel::executeAction	(	QUuid	action,
		const QModelIndex &	idx
	)		const

Execute an action.

Definition at line 785 of file qgsattributetablemodel.cpp.

◆ executeMapLayerAction()

void QgsAttributeTableModel::executeMapLayerAction	(	QgsMapLayerAction *	action,
		const QModelIndex &	idx
	)		const

Execute a QgsMapLayerAction.

Definition at line 791 of file qgsattributetablemodel.cpp.

◆ extraColumns()

int QgsAttributeTableModel::extraColumns ( ) const

Empty extra columns to announce from this model.

Any extra columns need to be implemented by proxy models in front of this model.

Definition at line 88 of file qgsattributetablemodel.cpp.

◆ feature()

QgsFeature QgsAttributeTableModel::feature ( const QModelIndex & idx ) const

Return the feature attributes at given model index.

Returns: feature attributes at given model index

Definition at line 797 of file qgsattributetablemodel.cpp.

◆ fieldCol()

int QgsAttributeTableModel::fieldCol ( int idx ) const

get column from field index

Definition at line 541 of file qgsattributetablemodel.cpp.

◆ fieldConditionalStyleChanged

void QgsAttributeTableModel::fieldConditionalStyleChanged ( const QString & fieldName )

slot

Handles updating the model when the conditional style for a field changes.

Parameters

fieldName name of field whose conditional style has changed

Since: QGIS 2.12

Definition at line 450 of file qgsattributetablemodel.cpp.

◆ fieldIdx()

int QgsAttributeTableModel::fieldIdx ( int col ) const

get field index from column

Definition at line 536 of file qgsattributetablemodel.cpp.

◆ finished

void QgsAttributeTableModel::finished ( )

signal

◆ flags()

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

override

Returns item flags for the index.

Parameters

index model index

Definition at line 741 of file qgsattributetablemodel.cpp.

◆ headerData()

QVariant QgsAttributeTableModel::headerData	(	int	section,
		Qt::Orientation	orientation,
		int	role = `Qt::DisplayRole`
	)		const

override

Returns header data.

Parameters

section	required section
orientation	horizontal or vertical orientation
role	data role

Definition at line 558 of file qgsattributetablemodel.cpp.

◆ idToIndex()

QModelIndex QgsAttributeTableModel::idToIndex ( QgsFeatureId id ) const

Definition at line 504 of file qgsattributetablemodel.cpp.

◆ idToIndexList()

QModelIndexList QgsAttributeTableModel::idToIndexList ( QgsFeatureId id ) const

Definition at line 509 of file qgsattributetablemodel.cpp.

◆ idToRow()

int QgsAttributeTableModel::idToRow ( QgsFeatureId id ) const

Maps feature id to table row.

Parameters

id	feature id

Definition at line 493 of file qgsattributetablemodel.cpp.

◆ layer()

QgsVectorLayer* QgsAttributeTableModel::layer ( ) const

inline

Returns the layer this model uses as backend.

Retrieved from the layer cache.

Definition at line 168 of file qgsattributetablemodel.h.

◆ layerCache()

QgsVectorLayerCache* QgsAttributeTableModel::layerCache ( ) const

inline

Returns the layer cache this model uses as backend.

Definition at line 173 of file qgsattributetablemodel.h.

◆ loadLayer

void QgsAttributeTableModel::loadLayer ( )

virtualslot

Loads the layer into the model Preferably to be called, before using this model as source for any other proxy model.

Definition at line 405 of file qgsattributetablemodel.cpp.

◆ modelChanged

void QgsAttributeTableModel::modelChanged ( )

signal

Model has been changed.

◆ prefetchColumnData()

void QgsAttributeTableModel::prefetchColumnData ( int column )

Caches the entire data for one column.

This should be called prior to sorting, so the data does not have to be fetched for every single comparison. Specify -1 as column to invalidate the cache

Parameters

column The column index of the field to catch

Definition at line 810 of file qgsattributetablemodel.cpp.

◆ prefetchSortData()

void QgsAttributeTableModel::prefetchSortData ( const QString & expression )

Prefetches the entire data for one expression.

Based on this cached information the sorting can later be done in a performant way.

Parameters

expression The expression to cache

Definition at line 822 of file qgsattributetablemodel.cpp.

◆ progress

void QgsAttributeTableModel::progress	(	int	i,
		bool &	cancel
	)

signal

Note: not available in Python bindings

◆ reload()

void QgsAttributeTableModel::reload	(	const QModelIndex &	index1,
		const QModelIndex &	index2
	)

Reloads the model data between indices.

Parameters

index1	start index
index2	end index

Definition at line 778 of file qgsattributetablemodel.cpp.

◆ removeRows()

bool QgsAttributeTableModel::removeRows	(	int	row,
		int	count,
		const QModelIndex &	parent = `QModelIndex()`
	)

override

Remove rows.

Definition at line 155 of file qgsattributetablemodel.cpp.

◆ request()

const QgsFeatureRequest & QgsAttributeTableModel::request ( ) const

Get the the feature request.

Definition at line 900 of file qgsattributetablemodel.cpp.

◆ resetModel()

void QgsAttributeTableModel::resetModel ( )

inline

Resets the model.

Alias to loadLayer()

Definition at line 130 of file qgsattributetablemodel.h.

◆ rowCount()

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

override

Returns the number of rows.

Parameters

parent parent index

Definition at line 546 of file qgsattributetablemodel.cpp.

◆ rowToId()

QgsFeatureId QgsAttributeTableModel::rowToId ( int row ) const

Maps row to feature id.

Parameters

row	row number

Definition at line 524 of file qgsattributetablemodel.cpp.

◆ setData()

bool QgsAttributeTableModel::setData	(	const QModelIndex &	index,
		const QVariant &	value,
		int	role = `Qt::EditRole`
	)

override

Updates data on given index.

Parameters

index	model index
value	new data value
role	data role

Definition at line 704 of file qgsattributetablemodel.cpp.

◆ setEditorContext()

void QgsAttributeTableModel::setEditorContext ( const QgsAttributeEditorContext & context )

inline

Sets the context in which this table is shown.

Will be forwarded to any editor widget created when editing data on this model.

Parameters

context The context

Definition at line 234 of file qgsattributetablemodel.h.

◆ setExtraColumns()

void QgsAttributeTableModel::setExtraColumns ( int extraColumns )

Empty extra columns to announce from this model.

Any extra columns need to be implemented by proxy models in front of this model.

Definition at line 93 of file qgsattributetablemodel.cpp.

◆ setRequest()

void QgsAttributeTableModel::setRequest ( const QgsFeatureRequest & request )

Set a request that will be used to fill this attribute table model.

In contrast to a filter, the request will constrain the data shown without the possibility to dynamically adjust it.

Parameters

request The request to use to fill this table model.

Definition at line 893 of file qgsattributetablemodel.cpp.

◆ sortCacheExpression()

QString QgsAttributeTableModel::sortCacheExpression ( ) const

The expression which was used to fill the sorting cache.

Definition at line 885 of file qgsattributetablemodel.cpp.

◆ swapRows()

void QgsAttributeTableModel::swapRows	(	QgsFeatureId	a,
		QgsFeatureId	b
	)

Swaps two rows.

Parameters

a	first row
b	second row

Definition at line 468 of file qgsattributetablemodel.cpp.

Friends And Related Function Documentation

◆ TestQgsAttributeTable

friend class TestQgsAttributeTable

friend

Definition at line 387 of file qgsattributetablemodel.h.

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

/tmp/buildd/qgis-3.0.2+14stretch/src/gui/attributetable/qgsattributetablemodel.h
/tmp/buildd/qgis-3.0.2+14stretch/src/gui/attributetable/qgsattributetablemodel.cpp

Public Types

Public Slots

Signals

Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ Role

Constructor & Destructor Documentation

◆ QgsAttributeTableModel()

Member Function Documentation

◆ columnCount()

◆ data()

◆ editorContext()

◆ executeAction()

◆ executeMapLayerAction()

◆ extraColumns()

◆ feature()

◆ fieldCol()

◆ fieldConditionalStyleChanged

◆ fieldIdx()

◆ finished

◆ flags()

◆ headerData()

◆ idToIndex()

◆ idToIndexList()

◆ idToRow()

◆ layer()

◆ layerCache()

◆ loadLayer

◆ modelChanged

◆ prefetchColumnData()

◆ prefetchSortData()

◆ progress

◆ reload()

◆ removeRows()

◆ request()

◆ resetModel()

◆ rowCount()

◆ rowToId()

◆ setData()

◆ setEditorContext()

◆ setExtraColumns()

◆ setRequest()

◆ sortCacheExpression()

◆ swapRows()

Friends And Related Function Documentation

◆ TestQgsAttributeTable