Class: QgsCptCityDataItem

Base class for all items in a QgsCptCityBrowserModel model.

Class Hierarchy

Base classes

QObject

Subclasses

QgsCptCityCollectionItem	A logical collection of subcollections and color ramps for use in QgsCptCityBrowserModel.
QgsCptCityColorRampItem	An item that represents a layer that can be opened with one of the providers for a QgsCptCityBrowserModel.

Methods

hasChildren
info
isPopulated	Returns True if the item is already populated.
isValid
name
path
rowCount
setIcon
setToolTip
shortInfo
toolTip
type

Virtual Methods

In PyQGIS, only methods marked as virtual can be safely overridden in a Python subclass of QgsCptCityDataItem. See the FAQ for more details.

acceptDrop	Returns True if the item accepts drag & dropped layers - e.g. for import.
addChildItem	Inserts a new child using alphabetical order based on mName, emits necessary signal to model before and after, sets parent and connects signals.
createChildren	Returns a vector of children items.
deleteChildItem	Removes and deletes a child item, signals to browser are emitted.
equal	Returns True if this item is equal to an other item.
handleDrop	Tries to process the data dropped on this item.
icon
leafCount	Returns the total count of "leaf" items (all children which are end nodes).
paramWidget
populate	Populates children using children vector created by createChildren().
refresh
removeChildItem	Removes a child item but doesn't delete it, signals to browser are emitted.

Static Methods

findItem

Finds a child index in vector of items using '==' operator.

Signals

beginInsertItems	Emitted before child items are added to this item.
beginRemoveItems	Emitted before child items are removed from this data item.
endInsertItems	Emitted after child items have been added to this data item.
endRemoveItems	Emitted after child items have been removed from this data item.

Attributes

AllRamps
Collection
ColorRamp
Directory
Selection

class qgis.core.QgsCptCityDataItem

Bases: QObject

AllRamps = 4

Collection = 1

ColorRamp = 0

Directory = 2

Selection = 3

class Type

Bases: int

virtual acceptDrop(self) → bool

Returns True if the item accepts drag & dropped layers - e.g. for import.

Deprecated since version 3.40: Is unused and will be removed in QGIS 4.0.

Return type:

bool

virtual addChildItem(self, child: QgsCptCityDataItem | None, refresh: bool = False)

Inserts a new child using alphabetical order based on mName, emits necessary signal to model before and after, sets parent and connects signals.

The refresh argument will refresh the populated item by emitting signals to the model.

Parameters:

• child (Optional[QgsCptCityDataItem])

• refresh (bool = False)

signal beginInsertItems(parent: QgsCptCityDataItem, first: int, last: int)

Emitted before child items are added to this item.

This signal must be followed by endInsertItems().

Parameters:

• parent (QgsCptCityDataItem) – the parent item having children added

• first (int) – index of first child item to be added

• last (int) – index last child item, after the addition has occurred

See also

endInsertItems()

signal beginRemoveItems(parent: QgsCptCityDataItem, first: int, last: int)

Emitted before child items are removed from this data item.

This signal must be followed by endRemoveItems().

Parameters:

• parent (QgsCptCityDataItem) – the parent item having children removed

• first (int) – index of first child item to be removed

• last (int) – index of the last child item to be removed

See also

endRemoveItems()

virtual createChildren(self) → List[QgsCptCityDataItem]

Returns a vector of children items.

Return type:

List[QgsCptCityDataItem]

virtual deleteChildItem(self, child: QgsCptCityDataItem | None)

Removes and deletes a child item, signals to browser are emitted.

Parameters:

child (Optional[QgsCptCityDataItem])

signal endInsertItems

Emitted after child items have been added to this data item.

This signal will always be preceded by beginInsertItems().

See also

beginInsertItems()

signal endRemoveItems

Emitted after child items have been removed from this data item.

This signal will always be preceded by beginRemoveItems().

See also

beginRemoveItems()

virtual equal(self, other: QgsCptCityDataItem | None) → bool

Returns True if this item is equal to an other item.

Parameters:

other (Optional[QgsCptCityDataItem])

Return type:

bool

static findItem(items: Iterable[QgsCptCityDataItem], item: QgsCptCityDataItem | None) → int

Finds a child index in vector of items using ‘==’ operator.

Parameters:

• items (Iterable[QgsCptCityDataItem])

• item (Optional[QgsCptCityDataItem])

Return type:

int

virtual handleDrop(self, data: QMimeData | None, action: Qt.DropAction) → bool

Tries to process the data dropped on this item.

Deprecated since version 3.40: Is unused and will be removed in QGIS 4.0.

Parameters:

• data (Optional[QMimeData])

• action (Qt.DropAction)

Return type:

bool

hasChildren(self) → bool

Return type:

bool

virtual icon(self) → QIcon

virtual icon(self, size: QSize) → QIcon

Return type:

QIcon

virtual icon(self, size: QSize) → QIcon

Parameters:

size (QSize)

Return type:

QIcon

info(self) → str

Return type:

str

isPopulated(self) → bool

Returns True if the item is already populated.

Return type:

bool

isValid(self) → bool

Return type:

bool

virtual leafCount(self) → int

Returns the total count of “leaf” items (all children which are end nodes).

Return type:

int

name(self) → str

Return type:

str

virtual paramWidget(self) → QWidget | None

Deprecated since version 3.40.

Is unused and will be removed in QGIS 4.0.

Return type:

Optional[QWidget]

path(self) → str

Return type:

str

virtual populate(self)

Populates children using children vector created by createChildren().

virtual refresh(self)

virtual removeChildItem(self, child: QgsCptCityDataItem | None) → QgsCptCityDataItem | None

Removes a child item but doesn’t delete it, signals to browser are emitted.

Return type:

Optional[QgsCptCityDataItem]

Returns:

pointer to the removed item or None if no such item was found

Parameters:

child (Optional[QgsCptCityDataItem])

rowCount(self) → int

Return type:

int

setIcon(self, icon: QIcon)

Parameters:

icon (QIcon)

setToolTip(self, msg: str | None)

Parameters:

msg (Optional[str])

shortInfo(self) → str

Return type:

str

toolTip(self) → str

Return type:

str

type(self) → QgsCptCityDataItem.Type

Return type:

QgsCptCityDataItem.Type