Class: QgsFeatureListView

class qgis.gui.QgsFeatureListView(parent: QWidget = None)

Bases: PyQt5.QtWidgets.QListView

Creates a feature list view

Parameters

parent (QWidget = None) – owner

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.

Methods

actionEvent

changeEvent

childEvent

closeEditor

closeEvent

commitData

connectNotify

contextMenuEvent

param event

create

currentChanged

currentEditSelection

Gets the currentEditSelection

customEvent

dataChanged

destroy

dirtyRegionOffset

disconnectNotify

displayExpression

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

dragEnterEvent

dragLeaveEvent

dragMoveEvent

drawFrame

dropEvent

dropIndicatorPosition

edit

editFirstFeature

editFirstFeature will try to edit the first feature of the list

editLastFeature

editLastFeature will try to edit the last feature of the list

editNextFeature

editNextFeature will try to edit next feature of the list

editPreviousFeature

editPreviousFeature will try to edit previous feature of the list

editorDestroyed

enterEvent

event

eventFilter

executeDelayedItemsLayout

featureListModel

Gets the featureListModel used by this view

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

horizontalOffset

horizontalScrollbarAction

horizontalScrollbarValueChanged

initPainter

initStyleOption

inputMethodEvent

isIndexHidden

isSignalConnected

keyPressEvent

param event

keyReleaseEvent

layerCache

Returns the layer cache

leaveEvent

metric

mouseDoubleClickEvent

mouseMoveEvent

param event

mousePressEvent

param event

mouseReleaseEvent

param event

moveCursor

moveEvent

nativeEvent

paintEvent

parserErrorString

Returns a detailed message about errors while parsing a QgsExpression.

receivers

rectForIndex

repaintRequested

repaintRequested(self)

resizeEvent

rowsAboutToBeRemoved

rowsInserted

scheduleDelayedItemsLayout

scrollContentsBy

scrollDirtyRegion

selectAll

Select all currently visible features

selectedIndexes

selectionChanged

selectionCommand

sender

senderSignalIndex

setCurrentFeatureEdited

Sets if the currently shown form has received any edit events so far.

setDirtyRegion

setDisplayExpression

The display expression is an expression used to render the fields into a single string which is displaied.

setEditSelection

Set the feature(s) to be edited

setFeatureSelectionManager

setFeatureSelectionManager

setModel

Set the QgsFeatureListModel which is used to retrieve information

setPositionForIndex

setSelection

setState

setViewportMargins

sharedPainter

showEvent

startDrag

state

tabletEvent

timerEvent

updateEditorData

updateEditorGeometries

updateGeometries

updateMicroFocus

verticalOffset

verticalScrollbarAction

verticalScrollbarValueChanged

viewOptions

viewportEvent

viewportMargins

viewportSizeHint

visualRegionForSelection

wheelEvent

Signals

currentEditSelectionChanged

Emitted whenever the current edit selection has been changed.

currentEditSelectionProgressChanged

Emitted whenever the current edit selection has been changed.

displayExpressionChanged

Emitted whenever the display expression is successfully changed

willShowContextMenu

Emitted when the context menu is created to add the specific actions to it

actionEvent()
changeEvent()
childEvent()
closeEditor()
closeEvent()
commitData()
connectNotify()
contextMenuEvent(self, event: QContextMenuEvent)
Parameters

event (QContextMenuEvent) –

create()
currentChanged()
currentEditSelection(self) → object

Gets the currentEditSelection

Return type

object

Returns

A list of edited feature ids

currentEditSelectionChanged

Emitted whenever the current edit selection has been changed.

Parameters

feat (QgsFeature) – the feature, which will be edited. [signal]

currentEditSelectionProgressChanged

Emitted whenever the current edit selection has been changed.

Parameters
  • progress (int) – the position of the feature in the list

  • count (int) – the number of features in the list

New in version 3.8: [signal]

customEvent()
dataChanged()
destroy()
dirtyRegionOffset()
disconnectNotify()
displayExpression(self) → str

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

Return type

str

Returns

A string containing the currend display expression

See also

QgsExpression

displayExpressionChanged

Emitted whenever the display expression is successfully changed

Parameters

expression (str) – The expression that was applied [signal]

dragEnterEvent()
dragLeaveEvent()
dragMoveEvent()
drawFrame()
dropEvent()
dropIndicatorPosition()
edit()
editFirstFeature(self)

editFirstFeature will try to edit the first feature of the list

New in version 3.8.

editLastFeature(self)

editLastFeature will try to edit the last feature of the list

New in version 3.8.

editNextFeature(self)

editNextFeature will try to edit next feature of the list

New in version 3.8.

editPreviousFeature(self)

editPreviousFeature will try to edit previous feature of the list

New in version 3.8.

editorDestroyed()
enterEvent()
event()
eventFilter()
executeDelayedItemsLayout()
featureListModel(self) → QgsFeatureListModel

Gets the featureListModel used by this view

Return type

QgsFeatureListModel

Returns

The model in use

focusInEvent()
focusNextChild()
focusNextPrevChild()
focusOutEvent()
focusPreviousChild()
hideEvent()
horizontalOffset()
horizontalScrollbarAction()
horizontalScrollbarValueChanged()
initPainter()
initStyleOption()
inputMethodEvent()
isIndexHidden()
isSignalConnected()
keyPressEvent(self, event: QKeyEvent)
Parameters

event (QKeyEvent) –

keyReleaseEvent()
layerCache(self) → QgsVectorLayerCache

Returns the layer cache

Return type

QgsVectorLayerCache

Returns

the layer cache used as backend

leaveEvent()
metric()
mouseDoubleClickEvent()
mouseMoveEvent(self, event: QMouseEvent)
Parameters

event (QMouseEvent) –

mousePressEvent(self, event: QMouseEvent)
Parameters

event (QMouseEvent) –

mouseReleaseEvent(self, event: QMouseEvent)
Parameters

event (QMouseEvent) –

moveCursor()
moveEvent()
nativeEvent()
paintEvent()
parserErrorString(self) → str

Returns a detailed message about errors while parsing a QgsExpression.

Return type

str

Returns

A message containing information about the parser error.

receivers()
rectForIndex()
repaintRequested(self, indexes: Iterable[QModelIndex])

repaintRequested(self)

Parameters

indexes (Iterable[QModelIndex]) –

resizeEvent()
rowsAboutToBeRemoved()
rowsInserted()
scheduleDelayedItemsLayout()
scrollContentsBy()
scrollDirtyRegion()
selectAll(self)

Select all currently visible features

selectedIndexes()
selectionChanged()
selectionCommand()
sender()
senderSignalIndex()
setCurrentFeatureEdited(self, state: bool)

Sets if the currently shown form has received any edit events so far.

Parameters

state (bool) – The state

setDirtyRegion()
setDisplayExpression(self, displayExpression: str) → bool

The display expression is an expression used to render the fields into a single string which is displaied.

Parameters

displayExpression (str) – The expression used to render the feature

See also

QgsExpression

Return type

bool

setEditSelection(self, fids: object)

Set the feature(s) to be edited

Parameters

fids (object) – A list of features to be edited

setEditSelection(self, index: QModelIndex, command: Union[QItemSelectionModel.SelectionFlags, QItemSelectionModel.SelectionFlag]) Set the feature(s) to be edited

Parameters
  • index – The selection to set

  • command – selection update mode

setFeatureSelectionManager(self, featureSelectionManager: QgsIFeatureSelectionManager)

setFeatureSelectionManager

Parameters

featureSelectionManager (QgsIFeatureSelectionManager) – We will take ownership

setModel(self, featureListModel: QgsFeatureListModel)

Set the QgsFeatureListModel which is used to retrieve information

Parameters

featureListModel (QgsFeatureListModel) – The model to use

setPositionForIndex()
setSelection()
setState()
setViewportMargins()
sharedPainter()
showEvent()
startDrag()
state()
tabletEvent()
timerEvent()
updateEditorData()
updateEditorGeometries()
updateGeometries()
updateMicroFocus()
verticalOffset()
verticalScrollbarAction()
verticalScrollbarValueChanged()
viewOptions()
viewportEvent()
viewportMargins()
viewportSizeHint()
visualRegionForSelection()
wheelEvent()
willShowContextMenu

Emitted when the context menu is created to add the specific actions to it

Parameters
  • menu (QgsActionMenu) – is the already created context menu

  • featureId (int) – is the ID of the current feature [signal]