Shows a list of features and renders a edit button next to each feature. More...

#include <qgsfeaturelistview.h>

Collaboration diagram for QgsFeatureListView:

Public Slots
void	setEditSelection (const QgsFeatureIds &fids)
	Set the feature(s) to be edited.
virtual void	selectAll ()
	Select all currently visible features.
void	repaintRequested (QModelIndexList indexes)
void	repaintRequested ()

Signals
void	currentEditSelectionChanged (QgsFeature &feat)
	Is emitted, whenever the current edit selection has been changed.
void	displayExpressionChanged (const QString expression)
	Is emitted, whenever the display expression is successfully changed.

Public Member Functions
	QgsFeatureListView (QWidget *parent=0)
	Creates a feature list view.
virtual	~QgsFeatureListView ()
	Destructor.
QgsVectorLayerCache *	layerCache ()
	Returns the layer cache.
virtual void	setModel (QgsFeatureListModel *featureListModel)
	Set the QgsFeatureListModel which is used to retrieve information.
QgsFeatureListModel *	featureListModel ()
	Get the featureListModel used by this view.
bool	setDisplayExpression (const QString displayExpression)
	The display expression is an expression used to render the fields into a single string which is displaied.
const QString	displayExpression () const
	Returns the expression which is currently used to render the features.
QString	parserErrorString ()
	Returns a detailed message about errors while parsing a QgsExpression.
QgsFeatureIds	currentEditSelection ()
	Get the currentEditSelection.

Protected Member Functions
virtual void	mouseMoveEvent (QMouseEvent *event)
virtual void	mousePressEvent (QMouseEvent *event)
virtual void	mouseReleaseEvent (QMouseEvent *event)
virtual void	keyPressEvent (QKeyEvent *event)

Private Slots
void	editSelectionChanged (QItemSelection deselected, QItemSelection selected)

Private Member Functions
void	selectRow (const QModelIndex &index, bool anchor)

Private Attributes
QgsFeatureListModel *	mModel
QItemSelectionModel *	mCurrentEditSelectionModel
QgsFeatureSelectionModel *	mFeatureSelectionModel
QgsFeatureListViewDelegate *	mItemDelegate
bool	mEditSelectionDrag
int	mRowAnchor
QItemSelectionModel::SelectionFlags	mCtrlDragSelectionFlag

Detailed Description

Shows a list of features and renders a edit button next to each feature.

Accepts a display expression to define the way, features are rendered. Uses a QgsFeatureListModel as source model.

Definition at line 41 of file qgsfeaturelistview.h.

Constructor & Destructor Documentation

QgsFeatureListView::QgsFeatureListView ( QWidget * parent = 0 )

explicit

Creates a feature list view.

Parameters

parent owner

Definition at line 35 of file qgsfeaturelistview.cpp.

virtual QgsFeatureListView::~QgsFeatureListView ( )

inlinevirtual

Destructor.

Definition at line 56 of file qgsfeaturelistview.h.

Member Function Documentation

QgsFeatureIds QgsFeatureListView::currentEditSelection ( )

Get the currentEditSelection.

Returns: A list of edited feature ids

Definition at line 100 of file qgsfeaturelistview.cpp.

References QgsAttributeTableModel::FeatureIdRole, and mCurrentEditSelectionModel.

void QgsFeatureListView::currentEditSelectionChanged ( QgsFeature & feat )

signal

Is emitted, whenever the current edit selection has been changed.

Parameters

feat	the feature, which will be edited.

Referenced by editSelectionChanged().

const QString QgsFeatureListView::displayExpression ( ) const

Returns the expression which is currently used to render the features.

Returns: A string containing the currend display expression

See Also: QgsExpression

Definition at line 90 of file qgsfeaturelistview.cpp.

References QgsFeatureListModel::displayExpression(), and mModel.

void QgsFeatureListView::displayExpressionChanged ( const QString expression )

signal

Is emitted, whenever the display expression is successfully changed.

Parameters

expression The expression that was applied

Referenced by setDisplayExpression().

void QgsFeatureListView::editSelectionChanged	(	QItemSelection	deselected,
		QItemSelection	selected
	)

privateslot

Definition at line 129 of file qgsfeaturelistview.cpp.

References currentEditSelectionChanged(), QgsFeatureListModel::featureByIndex(), QgsFeatureListModel::mapFromMaster(), QgsFeatureListModel::mapSelectionFromMaster(), mCurrentEditSelectionModel, and mModel.

Referenced by setModel().

QgsFeatureListModel* QgsFeatureListView::featureListModel ( )

inline

Get the featureListModel used by this view.

Returns: The model in use

Definition at line 75 of file qgsfeaturelistview.h.

Referenced by setModel().

void QgsFeatureListView::keyPressEvent ( QKeyEvent * event )

protectedvirtual

Definition at line 224 of file qgsfeaturelistview.cpp.

References QgsFeatureListModel::index(), QgsFeatureListModel::mapFromMaster(), QgsFeatureListModel::mapToMaster(), mCurrentEditSelectionModel, and mModel.

QgsVectorLayerCache * QgsFeatureListView::layerCache ( )

Returns the layer cache.

Returns: the layer cache used as backend

Definition at line 45 of file qgsfeaturelistview.cpp.

References QgsFeatureListModel::layerCache(), and mModel.

void QgsFeatureListView::mouseMoveEvent ( QMouseEvent * event )

protectedvirtual

This function is called with the given event when a mouse move event is sent to the widget. If a selection is in progress and new items are moved over the selection is extended; if a drag is in progress it is continued.

Definition at line 187 of file qgsfeaturelistview.cpp.

References index, QgsFeatureListModel::mapToMaster(), mCurrentEditSelectionModel, mEditSelectionDrag, mModel, and selectRow().

void QgsFeatureListView::mousePressEvent ( QMouseEvent * event )

protectedvirtual

Definition at line 110 of file qgsfeaturelistview.cpp.

References QgsFeatureListViewDelegate::EditElement, QgsFeatureSelectionModel::enableSync(), index, QgsFeatureListModel::mapToMaster(), mCurrentEditSelectionModel, mEditSelectionDrag, mFeatureSelectionModel, mItemDelegate, mModel, QgsFeatureListViewDelegate::positionToElement(), repaintRequested(), and selectRow().

void QgsFeatureListView::mouseReleaseEvent ( QMouseEvent * event )

protectedvirtual

This function is called with the given event when a mouse button is released, after a mouse press event on the widget. If a user presses the mouse inside your widget and then drags the mouse to another location before releasing the mouse button, your widget receives the release event. The function will emit the clicked() signal if an item was being pressed.

Definition at line 210 of file qgsfeaturelistview.cpp.

References QgsFeatureSelectionModel::enableSync(), mEditSelectionDrag, and mFeatureSelectionModel.

QString QgsFeatureListView::parserErrorString ( )

Returns a detailed message about errors while parsing a QgsExpression.