A proxy model for filtering an attribute table model. More...

#include <qgsattributetablefiltermodel.h>

Inheritance diagram for QgsAttributeTableFilterModel:

[legend]

Public Slots
Q_DECL_DEPRECATED void	extentsChanged ()
	Is called upon every change of the visible extents on the map canvas.
void	filterFeatures ()
	Updates the filtered features in the filter model.

Signals
void	featuresFiltered ()
	Emitted when the filtering of the features has been done.
void	filterError (const QString &errorMessage)
	Emitted when an error occurred while filtering features.
void	sortColumnChanged (int column, Qt::SortOrder order)
	Emitted whenever the sort column is changed.
void	visibleReloaded ()
	Emitted when the the visible features on extend are reloaded (the list is created).

Public Member Functions
	QgsAttributeTableFilterModel (QgsMapCanvas canvas, QgsAttributeTableModel sourceModel, QObject *parent=nullptr)
	Make sure, the master model is already loaded, so the selection will get synchronized.
Q_DECL_DEPRECATED int	actionColumnIndex () const
	Gets the index of the first column that contains an action widget.
void	connectFilterModeConnections (Qgis::AttributeTableFilterMode filterMode)
	Disconnect the connections set for the new filterMode.
void	disconnectFilterModeConnections ()
	Disconnect the connections set for the current filterMode.
QModelIndex	fidToIndex (QgsFeatureId fid) override
QModelIndexList	fidToIndexList (QgsFeatureId fid)
QgsFeatureIds	filteredFeatures () const
	Gets a list of currently filtered feature ids.
QString	filterExpression () const
	Returns the stored filter expression string.
Qgis::AttributeTableFilterMode	filterMode ()
	The current filterModel.
QgsVectorLayer *	layer () const
	Returns the layer this filter acts on.
QgsVectorLayerCache *	layerCache () const
	Returns the layerCache this filter acts on.
QgsMapCanvas *	mapCanvas () const
	Returns the map canvas.
QModelIndex	mapFromMaster (const QModelIndex &sourceIndex) const
QModelIndex	mapToMaster (const QModelIndex &proxyIndex) const
QgsAttributeTableModel *	masterModel () const
	Returns the table model this filter is using.
QgsFeatureId	rowToId (const QModelIndex &row) const
	Returns the feature id for a given model index.
bool	selectedOnTop ()
	Returns if selected features are currently shown on top.
void	setAttributeTableConfig (const QgsAttributeTableConfig &config, bool force=false)
	Set the attribute table configuration to control which fields are shown, in which order they are shown as well as if and where an action column is shown.
virtual void	setFilteredFeatures (const QgsFeatureIds &ids)
	Specify a list of features, which the filter will accept.
void	setFilterExpression (const QgsExpression &expression, const QgsExpressionContext &context)
	Set the expression and the context to be stored in case of the features need to be filtered again (like on filter or on main model data change).
void	setFilterMode (Qgis::AttributeTableFilterMode filterMode)
	Set the filter mode the filter will use.
void	setSelectedOnTop (bool selectedOnTop)
	Changes the sort order of the features.
void	setSourceModel (QgsAttributeTableModel *sourceModel)
	Set the attribute table model that backs this model.
void	sort (const QString &expression, Qt::SortOrder order=Qt::AscendingOrder)
	Sort by the given expression using the given order.
void	sort (int column, Qt::SortOrder order=Qt::AscendingOrder) override
	Sort by the given column using the given order.
QString	sortExpression () const
	The expression which is used to sort the attribute table.
Public Member Functions inherited from QgsFeatureModel
virtual	~QgsFeatureModel ()=default

Protected Member Functions
bool	filterAcceptsRow (int sourceRow, const QModelIndex &sourceParent) const override
	Returns `true` if the source row will be accepted.
void	generateListOfVisibleFeatures ()
	Updates the list of currently visible features on the map canvas.
bool	lessThan (const QModelIndex &left, const QModelIndex &right) const override
	Used by the sorting algorithm.

Detailed Description

A proxy model for filtering an attribute table model.

Definition at line 38 of file qgsattributetablefiltermodel.h.

Constructor & Destructor Documentation

◆ QgsAttributeTableFilterModel()

QgsAttributeTableFilterModel::QgsAttributeTableFilterModel	(	QgsMapCanvas *	canvas,
		QgsAttributeTableModel *	sourceModel,
		QObject *	parent = nullptr )

Make sure, the master model is already loaded, so the selection will get synchronized.

Parameters

parent	parent object (owner)
sourceModel	The QgsAttributeTableModel to use as source (mostly referred to as master model)
canvas	The mapCanvas. Used to identify the currently visible features.

Definition at line 45 of file qgsattributetablefiltermodel.cpp.

Member Function Documentation

◆ actionColumnIndex()

int QgsAttributeTableFilterModel::actionColumnIndex ( ) const

Gets the index of the first column that contains an action widget.

Returns -1 if none is defined.

Deprecated: QGIS 4.4

Definition at line 100 of file qgsattributetablefiltermodel.cpp.

◆ connectFilterModeConnections()

void QgsAttributeTableFilterModel::connectFilterModeConnections ( Qgis::AttributeTableFilterMode filterMode )

Disconnect the connections set for the new filterMode.

Definition at line 241 of file qgsattributetablefiltermodel.cpp.

◆ disconnectFilterModeConnections()

void QgsAttributeTableFilterModel::disconnectFilterModeConnections ( )

Disconnect the connections set for the current filterMode.

Definition at line 217 of file qgsattributetablefiltermodel.cpp.

◆ extentsChanged

void QgsAttributeTableFilterModel::extentsChanged ( )

slot

Is called upon every change of the visible extents on the map canvas.

When a change is signalled, the filter is updated and invalidated if needed.

Deprecated: QGIS 3.10.3. Made private as reloadVisible().

Definition at line 312 of file qgsattributetablefiltermodel.cpp.

◆ featuresFiltered

void QgsAttributeTableFilterModel::featuresFiltered ( )

signal

Emitted when the filtering of the features has been done.

◆ fidToIndex()

QModelIndex QgsAttributeTableFilterModel::fidToIndex ( QgsFeatureId fid )

overridevirtual

Implements QgsFeatureModel.

Definition at line 529 of file qgsattributetablefiltermodel.cpp.

◆ fidToIndexList()

QModelIndexList QgsAttributeTableFilterModel::fidToIndexList ( QgsFeatureId fid )

Definition at line 534 of file qgsattributetablefiltermodel.cpp.

◆ filterAcceptsRow()

bool QgsAttributeTableFilterModel::filterAcceptsRow	(	int	sourceRow,
		const QModelIndex &	sourceParent ) const

overrideprotected

Returns true if the source row will be accepted.

Parameters

sourceRow	row from the source model
sourceParent	parent index in the source model

Definition at line 266 of file qgsattributetablefiltermodel.cpp.

◆ filteredFeatures()

QgsFeatureIds QgsAttributeTableFilterModel::filteredFeatures ( ) const

Gets a list of currently filtered feature ids.

Returns: A list of feature ids

Definition at line 189 of file qgsattributetablefiltermodel.cpp.

◆ filterError

void QgsAttributeTableFilterModel::filterError ( const QString & errorMessage )

signal

Emitted when an error occurred while filtering features.

Since: QGIS 3.18

◆ filterExpression()

QString QgsAttributeTableFilterModel::filterExpression ( ) const

inline

Returns the stored filter expression string.

Since: QGIS 3.28.0

Definition at line 215 of file qgsattributetablefiltermodel.h.

◆ filterFeatures

void QgsAttributeTableFilterModel::filterFeatures ( )

slot

Updates the filtered features in the filter model.

It is called when the data of the main table or the filter expression changed.

Since: QGIS 3.10.3

Definition at line 353 of file qgsattributetablefiltermodel.cpp.

◆ filterMode()

Qgis::AttributeTableFilterMode QgsAttributeTableFilterModel::filterMode ( )

inline

The current filterModel.

Definition at line 119 of file qgsattributetablefiltermodel.h.

◆ generateListOfVisibleFeatures()

void QgsAttributeTableFilterModel::generateListOfVisibleFeatures ( )

protected

Updates the list of currently visible features on the map canvas.

Is called automatically when the filter mode is adjusted or the extents changed.

Definition at line 434 of file qgsattributetablefiltermodel.cpp.

◆ layer()

QgsVectorLayer * QgsAttributeTableFilterModel::layer ( ) const

inline

Returns the layer this filter acts on.

Returns: Abovementioned layer

Definition at line 126 of file qgsattributetablefiltermodel.h.

◆ layerCache()

QgsVectorLayerCache * QgsAttributeTableFilterModel::layerCache ( ) const

inline

Returns the layerCache this filter acts on.

Returns: The layer cache

Definition at line 133 of file qgsattributetablefiltermodel.h.

◆ lessThan()

bool QgsAttributeTableFilterModel::lessThan	(	const QModelIndex &	left,
		const QModelIndex &	right ) const

overrideprotected

Used by the sorting algorithm.

Compares the two model indices. Will also consider the selection state of the feature in case selected features are to be shown on top.

Definition at line 60 of file qgsattributetablefiltermodel.cpp.

◆ mapCanvas()

QgsMapCanvas * QgsAttributeTableFilterModel::mapCanvas ( ) const

inline

Returns the map canvas.

Definition at line 183 of file qgsattributetablefiltermodel.h.

◆ mapFromMaster()

QModelIndex QgsAttributeTableFilterModel::mapFromMaster ( const QModelIndex & sourceIndex ) const

inline

Definition at line 157 of file qgsattributetablefiltermodel.h.

◆ mapToMaster()

QModelIndex QgsAttributeTableFilterModel::mapToMaster ( const QModelIndex & proxyIndex ) const

Definition at line 546 of file qgsattributetablefiltermodel.cpp.

◆ masterModel()

QgsAttributeTableModel * QgsAttributeTableFilterModel::masterModel ( ) const

inline

Returns the table model this filter is using.

Returns: the table model in quesion

Definition at line 140 of file qgsattributetablefiltermodel.h.

◆ rowToId()

QgsFeatureId QgsAttributeTableFilterModel::rowToId ( const QModelIndex & row ) const

Returns the feature id for a given model index.

Parameters

row	A model index of the row in question

Returns: The feature id of the feature visible in the provided row

Definition at line 524 of file qgsattributetablefiltermodel.cpp.

◆ selectedOnTop()

bool QgsAttributeTableFilterModel::selectedOnTop ( )

Returns if selected features are currently shown on top.

Returns: true if selected are shown on top

Definition at line 174 of file qgsattributetablefiltermodel.cpp.

◆ setAttributeTableConfig()

void QgsAttributeTableFilterModel::setAttributeTableConfig	(	const QgsAttributeTableConfig &	config,
		bool	force = false )

Set the attribute table configuration to control which fields are shown, in which order they are shown as well as if and where an action column is shown.

Parameters

config	attribute table config
force	default `false`, if `true` the attribute table configuration will be reset even if it is not changed.

Definition at line 105 of file qgsattributetablefiltermodel.cpp.

◆ setFilteredFeatures()

void QgsAttributeTableFilterModel::setFilteredFeatures ( const QgsFeatureIds & ids )

virtual

Specify a list of features, which the filter will accept.

The filter mode will automatically be adjusted to show only these features (ShowFilteredList).

Parameters

ids	The list of feature ids which will be accepted by the filter

Definition at line 179 of file qgsattributetablefiltermodel.cpp.

◆ setFilterExpression()

void QgsAttributeTableFilterModel::setFilterExpression	(	const QgsExpression &	expression,
		const QgsExpressionContext &	context )

Set the expression and the context to be stored in case of the features need to be filtered again (like on filter or on main model data change).

Since: QGIS 3.10.3

Definition at line 122 of file qgsattributetablefiltermodel.cpp.

◆ setFilterMode()

void QgsAttributeTableFilterModel::setFilterMode ( Qgis::AttributeTableFilterMode filterMode )

Set the filter mode the filter will use.

Parameters

filterMode Sets the current mode of the filter

Definition at line 201 of file qgsattributetablefiltermodel.cpp.

◆ setSelectedOnTop()

void QgsAttributeTableFilterModel::setSelectedOnTop ( bool selectedOnTop )

Changes the sort order of the features.

If set to true, selected features will be sorted on top, regardless of the current sort column

Parameters

selectedOnTop Specify, if selected features should be sorted on top

Definition at line 143 of file qgsattributetablefiltermodel.cpp.

◆ setSourceModel()

void QgsAttributeTableFilterModel::setSourceModel ( QgsAttributeTableModel * sourceModel )

Set the attribute table model that backs this model.

Parameters

sourceModel The model

Definition at line 163 of file qgsattributetablefiltermodel.cpp.

◆ sort() [1/2]

void QgsAttributeTableFilterModel::sort	(	const QString &	expression,
		Qt::SortOrder	order = Qt::AscendingOrder )

Sort by the given expression using the given order.

Prefetches all the data from the layer to speed up sorting.

Parameters

expression	The expression which should be used for sorting
order	The order ( Qt::AscendingOrder or Qt::DescendingOrder )

Definition at line 128 of file qgsattributetablefiltermodel.cpp.

◆ sort() [2/2]

void QgsAttributeTableFilterModel::sort	(	int	column,
		Qt::SortOrder	order = Qt::AscendingOrder )

override

Sort by the given column using the given order.

Prefetches all the data from the layer to speed up sorting.

Parameters

column	The column which should be sorted
order	The order ( Qt::AscendingOrder or Qt::DescendingOrder )

Definition at line 86 of file qgsattributetablefiltermodel.cpp.

◆ sortColumnChanged

void QgsAttributeTableFilterModel::sortColumnChanged	(	int	column,
		Qt::SortOrder	order )

signal

Emitted whenever the sort column is changed.

Parameters

column	The sort column
order	The sort order

◆ sortExpression()

QString QgsAttributeTableFilterModel::sortExpression ( ) const

The expression which is used to sort the attribute table.

Definition at line 138 of file qgsattributetablefiltermodel.cpp.

◆ visibleReloaded

void QgsAttributeTableFilterModel::visibleReloaded ( )

signal

Emitted when the the visible features on extend are reloaded (the list is created).

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

/build/qgis-4.3.0+git20261103+bd2f5e21fd1+99sid/src/gui/attributetable/qgsattributetablefiltermodel.h
/build/qgis-4.3.0+git20261103+bd2f5e21fd1+99sid/src/gui/attributetable/qgsattributetablefiltermodel.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsAttributeTableFilterModel()

Member Function Documentation

◆ actionColumnIndex()

◆ connectFilterModeConnections()

◆ disconnectFilterModeConnections()

◆ extentsChanged

◆ featuresFiltered

◆ fidToIndex()

◆ fidToIndexList()

◆ filterAcceptsRow()

◆ filteredFeatures()

◆ filterError

◆ filterExpression()

◆ filterFeatures

◆ filterMode()

◆ generateListOfVisibleFeatures()

◆ layer()

◆ layerCache()

◆ lessThan()

◆ mapCanvas()

◆ mapFromMaster()

◆ mapToMaster()

◆ masterModel()

◆ rowToId()

◆ selectedOnTop()

◆ setAttributeTableConfig()

◆ setFilteredFeatures()

◆ setFilterExpression()

◆ setFilterMode()

◆ setSelectedOnTop()

◆ setSourceModel()

◆ sort() [1/2]

◆ sort() [2/2]

◆ sortColumnChanged

◆ sortExpression()

◆ visibleReloaded