#include <qgsattributetablefiltermodel.h>

Inheritance diagram for QgsAttributeTableFilterModel:

Public Types
enum	ColumnType { ColumnTypeField, ColumnTypeActionButton }
	The type of a column. More...

enum	FilterMode { ShowAll, ShowSelected, ShowVisible, ShowFilteredList, ShowEdited }
	The filter mode defines how the rows should be filtered. More...

enum	Role { TypeRole = QgsAttributeTableModel::UserRole }
	The additional roles defined by this filter model. More...

Public Slots
void	extentsChanged ()
	Is called upon every change of the visible extents on the map canvas. More...

Signals
void	sortColumnChanged (int column, Qt::SortOrder order)
	Is emitted whenever the sort column is changed. More...

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. More...

int	actionColumnIndex () const
	Get the index of the first column that contains an action widget. More...

int	columnCount (const QModelIndex &parent) const override

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

QModelIndex	fidToIndex (QgsFeatureId fid) override

QModelIndexList	fidToIndexList (QgsFeatureId fid)

QgsFeatureIds	filteredFeatures ()
	Get a list of currently filtered feature ids. More...

FilterMode	filterMode ()
	The current filterModel. More...

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. More...

QgsVectorLayerCache *	layerCache () const
	Returns the layerCache this filter acts on. More...

QgsMapCanvas *	mapCanvas () const
	Returns the map canvas. More...

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. More...

QgsFeatureId	rowToId (const QModelIndex &row)
	Returns the feature id for a given model index. More...

bool	selectedOnTop ()
	Returns if selected features are currently shown on top. More...

void	setAttributeTableConfig (const QgsAttributeTableConfig &config)
	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. More...

virtual void	setFilteredFeatures (const QgsFeatureIds &ids)
	Specify a list of features, which the filter will accept. More...

void	setFilterMode (FilterMode filterMode)
	Set the filter mode the filter will use. More...

void	setSelectedOnTop (bool selectedOnTop)
	Changes the sort order of the features. More...

void	setSourceModel (QgsAttributeTableModel *sourceModel)
	Set the attribute table model that backs this model. More...

void	sort (int column, Qt::SortOrder order=Qt::AscendingOrder) override
	Sort by the given column using the given order. More...

void	sort (const QString &expression, Qt::SortOrder order=Qt::AscendingOrder)
	Sort by the given expression using the given order. More...

QString	sortExpression () const
	The expression which is used to sort the attribute table. More...

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. More...

void	generateListOfVisibleFeatures ()
	Updates the list of currently visible features on the map canvas. More...

bool	lessThan (const QModelIndex &left, const QModelIndex &right) const override
	Used by the sorting algorithm. More...

Detailed Description

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

◆ FilterMode

enum QgsAttributeTableFilterModel::FilterMode

The filter mode defines how the rows should be filtered.

Enumerator
ShowAll	Show all features.
ShowSelected	Show only selected features.
ShowVisible	Show only visible features (depends on the map canvas)
ShowFilteredList	Show only features whose ids are on the filter list. {. See also setFilteredFeatures}
ShowEdited	Show only features which have unsaved changes.

Definition at line 45 of file qgsattributetablefiltermodel.h.

◆ Role

enum QgsAttributeTableFilterModel::Role

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.

Enumerator
TypeRole	The type of a given column.

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

Member Function Documentation

◆ actionColumnIndex()

int QgsAttributeTableFilterModel::actionColumnIndex ( ) const

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

Returns -1 if none is defined.

Definition at line 121 of file qgsattributetablefiltermodel.cpp.

◆ columnCount()

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

override

Definition at line 126 of file qgsattributetablefiltermodel.cpp.

◆ data()

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

override

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

Definition at line 373 of file qgsattributetablefiltermodel.cpp.

◆ fidToIndex()

QModelIndex QgsAttributeTableFilterModel::fidToIndex ( QgsFeatureId fid )

overridevirtual

Implements QgsFeatureModel.

Definition at line 495 of file qgsattributetablefiltermodel.cpp.

◆ fidToIndexList()

QModelIndexList QgsAttributeTableFilterModel::fidToIndexList ( QgsFeatureId fid )

Definition at line 500 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 328 of file qgsattributetablefiltermodel.cpp.

◆ filteredFeatures()

QgsFeatureIds QgsAttributeTableFilterModel::filteredFeatures ( )

Get a list of currently filtered feature ids.

Returns: A list of feature ids

Definition at line 297 of file qgsattributetablefiltermodel.cpp.

◆ filterMode()

FilterMode QgsAttributeTableFilterModel::filterMode ( )

inline

The current filterModel.

Definition at line 134 of file qgsattributetablefiltermodel.h.

◆ flags()

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

override

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

◆ headerData()

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

override

Definition at line 100 of file qgsattributetablefiltermodel.cpp.

◆ layer()

QgsVectorLayer* QgsAttributeTableFilterModel::layer ( ) const

inline

Returns the layer this filter acts on.

Returns: Abovementioned layer

Definition at line 141 of file qgsattributetablefiltermodel.h.

◆ layerCache()

QgsVectorLayerCache* QgsAttributeTableFilterModel::layerCache ( ) const

inline

Returns the layerCache this filter acts on.

Returns: The layer cache

Definition at line 148 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 44 of file qgsattributetablefiltermodel.cpp.

◆ mapCanvas()

QgsMapCanvas* QgsAttributeTableFilterModel::mapCanvas ( ) const

inline

Returns the map canvas.

Definition at line 204 of file qgsattributetablefiltermodel.h.

◆ mapFromMaster()

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

inline

Definition at line 172 of file qgsattributetablefiltermodel.h.

◆ mapFromSource()

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

override

Definition at line 526 of file qgsattributetablefiltermodel.cpp.

◆ mapToMaster()

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

inline

Definition at line 170 of file qgsattributetablefiltermodel.h.

◆ mapToSource()

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

override

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

◆ rowToId()

QgsFeatureId QgsAttributeTableFilterModel::rowToId ( const QModelIndex & row )

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 490 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 285 of file qgsattributetablefiltermodel.cpp.

◆ setAttributeTableConfig()

void QgsAttributeTableFilterModel::setAttributeTableConfig ( const QgsAttributeTableConfig & config )

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.

Definition at line 132 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 290 of file qgsattributetablefiltermodel.cpp.

◆ setFilterMode()

void QgsAttributeTableFilterModel::setFilterMode ( FilterMode filterMode )

Set the filter mode the filter will use.

Parameters

filterMode Sets the current mode of the filter

Definition at line 309 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 243 of file qgsattributetablefiltermodel.cpp.

◆ setSourceModel()

void QgsAttributeTableFilterModel::setSourceModel ( QgsAttributeTableModel * sourceModel )

Set the attribute table model that backs this model.

Parameters

sourceModel The model

Since: QGIS 2.0

Definition at line 263 of file qgsattributetablefiltermodel.cpp.

◆ sort() [1/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 71 of file qgsattributetablefiltermodel.cpp.

◆ sort() [2/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 228 of file qgsattributetablefiltermodel.cpp.

◆ sortColumnChanged

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

signal

Is 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 238 of file qgsattributetablefiltermodel.cpp.

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

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

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ ColumnType

◆ FilterMode

◆ Role

Constructor & Destructor Documentation

◆ QgsAttributeTableFilterModel()

Member Function Documentation

◆ actionColumnIndex()

◆ columnCount()

◆ data()

◆ extentsChanged

◆ fidToIndex()

◆ fidToIndexList()

◆ filterAcceptsRow()

◆ filteredFeatures()

◆ filterMode()

◆ flags()

◆ generateListOfVisibleFeatures()

◆ headerData()

◆ layer()

◆ layerCache()

◆ lessThan()

◆ mapCanvas()

◆ mapFromMaster()

◆ mapFromSource()

◆ mapToMaster()

◆ mapToSource()

◆ masterModel()

◆ rowToId()

◆ selectedOnTop()

◆ setAttributeTableConfig()

◆ setFilteredFeatures()

◆ setFilterMode()

◆ setSelectedOnTop()

◆ setSourceModel()

◆ sort() [1/2]

◆ sort() [2/2]

◆ sortColumnChanged

◆ sortExpression()