Class: QgsProjectItem

class qgis.core.QgsProjectItem

Bases: QgsDataItem

Data item that can be used to represent QGIS projects.

QgsProjectItem(parent: QgsDataItem, name: str, path: str, providerKey: str = ‘’) A data item holding a reference to a QGIS project file.

childEvent(self, QChildEvent)
connectNotify(self, QMetaMethod)
customEvent(self, QEvent)
deferredDelete(self) bool

The item is scheduled to be deleted. E.g. if deleteLater() is called when item is in Populating state (createChildren() running in another thread), the deferredDelete() returns True and item will be deleted once Populating finished. Items with slow reateChildren() (for example network or database based) may check during createChildren() if deferredDelete() returns True and return from createChildren() immediately because result will be useless.

disconnectNotify(self, QMetaMethod)
hasDragEnabled(self) bool
Return type:


isSignalConnected(self, QMetaMethod) bool
mimeUris(self) List[QgsMimeDataUtils.Uri]
Return type:


populate(self, children: Iterable[QgsDataItem])
populate(self, foreground: bool = False) None
receivers(self, PYQT_SIGNAL) int
refresh(self, children: Iterable[QgsDataItem])

Refresh the items from a specified list of child items.


sender(self) QObject
senderSignalIndex(self) int
timerEvent(self, QTimerEvent)

Will request a repaint of this icon.

New in version 3.0.