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

#include <qgsattributetablefiltermodel.h>

Inheritance diagram for QgsAttributeTableFilterModel:

[legend]

Public Types
enum	ColumnType { ColumnTypeField , ColumnTypeActionButton }
	The type of a column. More...
enum class	CustomRole : int { Type = static_cast<int>( QgsAttributeTableModel::CustomRole::User ) }
	The additional roles defined by this filter model. More...

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.
int	actionColumnIndex () const
	Gets the index of the first column that contains an action widget.
int	columnCount (const QModelIndex &parent) const override
void	connectFilterModeConnections (Qgis::AttributeTableFilterMode filterMode)
	Disconnect the connections set for the new filterMode.
QVariant	data (const QModelIndex &index, int role) const override
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.
Qt::ItemFlags	flags (const QModelIndex &index) const override
QVariant	headerData (int section, Qt::Orientation orientation, int role) const override
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	mapFromSource (const QModelIndex &sourceIndex) const override
QModelIndex	mapToMaster (const QModelIndex &proxyIndex) const
QModelIndex	mapToSource (const QModelIndex &proxyIndex) const override
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.

Member Enumeration Documentation

◆ ColumnType

enum QgsAttributeTableFilterModel::ColumnType

The type of a column.

Enumerator
ColumnTypeField	This column shows a field.
ColumnTypeActionButton	This column shows action buttons.

Definition at line 46 of file qgsattributetablefiltermodel.h.

◆ CustomRole

enum class QgsAttributeTableFilterModel::CustomRole : int

strong

The additional roles defined by this filter model.

The values of these roles start just after the roles defined by QgsAttributeTableModel so they do not conflict.

Note: Prior to QGIS 3.36 this was available as QgsAttributeTableFilterModel::Role

Since: QGIS 3.36

Enumerator
Type	The type of a given column.

Definition at line 62 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.

Definition at line 150 of file qgsattributetablefiltermodel.cpp.

◆ columnCount()

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

override

Definition at line 155 of file qgsattributetablefiltermodel.cpp.

◆ connectFilterModeConnections()

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

Disconnect the connections set for the new filterMode.

Definition at line 386 of file qgsattributetablefiltermodel.cpp.

◆ data()

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

override

Definition at line 103 of file qgsattributetablefiltermodel.cpp.

◆ disconnectFilterModeConnections()

void QgsAttributeTableFilterModel::disconnectFilterModeConnections ( )

Disconnect the connections set for the current filterMode.

Definition at line 362 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 457 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 692 of file qgsattributetablefiltermodel.cpp.

◆ fidToIndexList()

QModelIndexList QgsAttributeTableFilterModel::fidToIndexList ( QgsFeatureId fid )

Definition at line 697 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 411 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 334 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 251 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 498 of file qgsattributetablefiltermodel.cpp.

◆ filterMode()

Qgis::AttributeTableFilterMode QgsAttributeTableFilterModel::filterMode ( )

inline

The current filterModel.

Definition at line 145 of file qgsattributetablefiltermodel.h.

◆ flags()

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

override

Definition at line 738 of file qgsattributetablefiltermodel.cpp.

◆ 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 597 of file qgsattributetablefiltermodel.cpp.

◆ headerData()

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

override

Definition at line 126 of file qgsattributetablefiltermodel.cpp.

◆ layer()

QgsVectorLayer * QgsAttributeTableFilterModel::layer ( ) const

inline

Returns the layer this filter acts on.

Returns: Abovementioned layer

Definition at line 152 of file qgsattributetablefiltermodel.h.

◆ layerCache()

QgsVectorLayerCache * QgsAttributeTableFilterModel::layerCache ( ) const

inline

Returns the layerCache this filter acts on.

Returns: The layer cache

Definition at line 159 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 215 of file qgsattributetablefiltermodel.h.

◆ mapFromMaster()

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

inline

Definition at line 183 of file qgsattributetablefiltermodel.h.

◆ mapFromSource()

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

override

Definition at line 723 of file qgsattributetablefiltermodel.cpp.

◆ mapToMaster()

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

Definition at line 751 of file qgsattributetablefiltermodel.cpp.

◆ mapToSource()

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

override

Definition at line 709 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 166 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 687 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 319 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 163 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 324 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 262 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 346 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 283 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 303 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 268 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 278 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+git20261026+16eddb2670e+99sid/src/gui/attributetable/qgsattributetablefiltermodel.h
/build/qgis-4.3.0+git20261026+16eddb2670e+99sid/src/gui/attributetable/qgsattributetablefiltermodel.cpp

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ ColumnType

◆ CustomRole

Constructor & Destructor Documentation

◆ QgsAttributeTableFilterModel()

Member Function Documentation

◆ actionColumnIndex()

◆ columnCount()

◆ connectFilterModeConnections()

◆ data()

◆ disconnectFilterModeConnections()

◆ extentsChanged

◆ featuresFiltered

◆ fidToIndex()

◆ fidToIndexList()

◆ filterAcceptsRow()

◆ filteredFeatures()

◆ filterError

◆ filterExpression()

◆ filterFeatures

◆ filterMode()

◆ flags()

◆ generateListOfVisibleFeatures()

◆ headerData()

◆ layer()

◆ layerCache()

◆ lessThan()

◆ mapCanvas()

◆ mapFromMaster()

◆ mapFromSource()

◆ mapToMaster()

◆ mapToSource()

◆ masterModel()

◆ rowToId()

◆ selectedOnTop()

◆ setAttributeTableConfig()

◆ setFilteredFeatures()

◆ setFilterExpression()

◆ setFilterMode()

◆ setSelectedOnTop()

◆ setSourceModel()

◆ sort() [1/2]

◆ sort() [2/2]

◆ sortColumnChanged

◆ sortExpression()

◆ visibleReloaded