QGIS API Documentation 3.32.0-Lima (311a8cb8a6)
|
The QgsLayerTreeView class extends QTreeView and provides some additional functionality when working with a layer tree. More...
#include <qgslayertreeview.h>
Public Slots | |
void | collapseAllNodes () |
Enhancement of QTreeView::collapseAll() that also records expanded state in layer tree nodes. More... | |
void | expandAllNodes () |
Enhancement of QTreeView::expandAll() that also records expanded state in layer tree nodes. More... | |
void | refreshLayerSymbology (const QString &layerId) |
Force refresh of layer symbology. Normally not needed as the changes of layer's renderer are monitored by the model. More... | |
void | setLayerMarkWidth (int width) |
Set width of contextual menu mark, at right of layer node items. More... | |
void | setMessageBar (QgsMessageBar *messageBar) |
Set the message bar to display messages from the layer tree. More... | |
void | setShowPrivateLayers (bool showPrivate) |
Set the show private layers to showPrivate. More... | |
bool | showPrivateLayers () |
Returns the show private layers status. More... | |
Signals | |
void | contextMenuAboutToShow (QMenu *menu) |
Emitted when the context menu is about to show. More... | |
void | currentLayerChanged (QgsMapLayer *layer) |
Emitted when a current layer is changed. More... | |
void | datasetsDropped (QDropEvent *event) |
Emitted when datasets are dropped onto the layer tree view. More... | |
Public Member Functions | |
QgsLayerTreeView (QWidget *parent=nullptr) | |
Constructor for QgsLayerTreeView. More... | |
~QgsLayerTreeView () override | |
void | addIndicator (QgsLayerTreeNode *node, QgsLayerTreeViewIndicator *indicator) |
Adds an indicator to the given layer tree node. More... | |
QgsLayerTreeGroup * | currentGroupNode () const |
Gets current group node. If a layer is current node, the function will return parent group. May be nullptr . More... | |
QgsMapLayer * | currentLayer () const |
Returns the currently selected layer, or nullptr if no layers is selected. More... | |
QgsLayerTreeModelLegendNode * | currentLegendNode () const |
Gets current legend node. More... | |
QgsLayerTreeNode * | currentNode () const |
Gets current node. May be nullptr . More... | |
QgsLayerTreeViewDefaultActions * | defaultActions () |
Gets access to the default actions that may be used with the tree view. More... | |
QgsLayerTreeModelLegendNode * | index2legendNode (const QModelIndex &index) const |
Returns legend node for given proxy model tree index. More... | |
QgsLayerTreeNode * | index2node (const QModelIndex &index) const |
Returns layer tree node for given proxy model tree index. More... | |
QList< QgsLayerTreeViewIndicator * > | indicators (QgsLayerTreeNode *node) const |
Returns list of indicators associated with a particular layer tree node. More... | |
int | layerMarkWidth () const |
Returns width of contextual menu mark, at right of layer node items. More... | |
QgsLayerTreeModel * | layerTreeModel () const |
Gets access to the model casted to QgsLayerTreeModel. More... | |
QModelIndex | legendNode2index (QgsLayerTreeModelLegendNode *legendNode) |
Returns proxy model index for a given legend node. More... | |
QModelIndex | legendNode2sourceIndex (QgsLayerTreeModelLegendNode *legendNode) |
Returns index for a given legend node. More... | |
QgsLayerTreeViewMenuProvider * | menuProvider () const |
Returns pointer to the context menu provider. May be nullptr . More... | |
QModelIndex | node2index (QgsLayerTreeNode *node) const |
Returns proxy model index for a given node. More... | |
QModelIndex | node2sourceIndex (QgsLayerTreeNode *node) const |
Returns source model index for a given node. More... | |
QgsLayerTreeProxyModel * | proxyModel () const |
Returns the proxy model used by the view. More... | |
void | removeIndicator (QgsLayerTreeNode *node, QgsLayerTreeViewIndicator *indicator) |
Removes a previously added indicator to a layer tree node. More... | |
QList< QgsLayerTreeLayer * > | selectedLayerNodes () const |
Returns the list of selected nodes filtered to just layer nodes (QgsLayerTreeLayer). More... | |
QList< QgsMapLayer * > | selectedLayers () const |
Returns the list of selected layers. More... | |
QList< QgsMapLayer * > | selectedLayersRecursive () const |
Gets list of selected layers, including those that are not directly selected, but their ancestor groups is selected. More... | |
QList< QgsLayerTreeModelLegendNode * > | selectedLegendNodes () const |
Returns the list of selected legend nodes. More... | |
QList< QgsLayerTreeNode * > | selectedNodes (bool skipInternal=false) const |
Returns the list of selected layer tree nodes. More... | |
void | setCurrentLayer (QgsMapLayer *layer) |
Sets the currently selected layer. More... | |
void | setLayerVisible (QgsMapLayer *layer, bool visible) |
Convenience methods which sets the visible state of the specified map layer. More... | |
void | setMenuProvider (QgsLayerTreeViewMenuProvider *menuProvider) |
Sets provider for context menu. Takes ownership of the instance. More... | |
void | setModel (QAbstractItemModel *model) override |
Overridden setModel() from base class. Only QgsLayerTreeModel is an acceptable model. More... | |
Protected Slots | |
void | modelRowsInserted (const QModelIndex &index, int start, int end) |
void | modelRowsRemoved () |
void | onCurrentChanged () |
void | onExpandedChanged (QgsLayerTreeNode *node, bool expanded) |
void | onModelReset () |
void | updateExpandedStateToNode (const QModelIndex &index) |
Protected Member Functions | |
void | contextMenuEvent (QContextMenuEvent *event) override |
void | dragEnterEvent (QDragEnterEvent *event) override |
void | dragMoveEvent (QDragMoveEvent *event) override |
void | dropEvent (QDropEvent *event) override |
void | keyPressEvent (QKeyEvent *event) override |
QgsMapLayer * | layerForIndex (const QModelIndex &index) const |
void | mouseReleaseEvent (QMouseEvent *event) override |
void | resizeEvent (QResizeEvent *event) override |
void | updateExpandedStateFromNode (QgsLayerTreeNode *node) |
Protected Attributes | |
QString | mCurrentLayerID |
Keeps track of current layer ID (to check when to emit signal about change of current layer) More... | |
QgsLayerTreeViewDefaultActions * | mDefaultActions = nullptr |
helper class with default actions. Lazily initialized. More... | |
QHash< QgsLayerTreeNode *, QList< QgsLayerTreeViewIndicator * > > | mIndicators |
Storage of indicators used with the tree view. More... | |
QPoint | mLastReleaseMousePos |
Used by the item delegate for identification of which indicator has been clicked. More... | |
int | mLayerMarkWidth |
Width of contextual menu mark for layer nodes. More... | |
QgsLayerTreeViewMenuProvider * | mMenuProvider = nullptr |
Context menu provider. Owned by the view. More... | |
Friends | |
class | QgsLayerTreeViewItemDelegate |
The QgsLayerTreeView class extends QTreeView and provides some additional functionality when working with a layer tree.
The view updates expanded state of layer tree nodes and also listens to changes to expanded states in the layer tree.
The view keeps track of the current layer and emits a signal when the current layer has changed.
Allows the client to specify a context menu provider with custom actions. Also it comes with a set of default actions that can be used when building context menu.
Definition at line 103 of file qgslayertreeview.h.
|
explicit |
Constructor for QgsLayerTreeView.
Definition at line 43 of file qgslayertreeview.cpp.
|
override |
Definition at line 77 of file qgslayertreeview.cpp.
void QgsLayerTreeView::addIndicator | ( | QgsLayerTreeNode * | node, |
QgsLayerTreeViewIndicator * | indicator | ||
) |
Adds an indicator to the given layer tree node.
Indicators are icons shown next to layer/group names in the layer tree view. They can be used to show extra information with tree nodes and they allow user interaction.
Does not take ownership of the indicator. One indicator object may be used for multiple layer tree nodes.
Definition at line 488 of file qgslayertreeview.cpp.
|
slot |
Enhancement of QTreeView::collapseAll() that also records expanded state in layer tree nodes.
Definition at line 569 of file qgslayertreeview.cpp.
|
signal |
Emitted when the context menu is about to show.
Allows customization of the menu.
|
overrideprotected |
Definition at line 173 of file qgslayertreeview.cpp.
QgsLayerTreeGroup * QgsLayerTreeView::currentGroupNode | ( | ) | const |
Gets current group node. If a layer is current node, the function will return parent group. May be nullptr
.
Definition at line 394 of file qgslayertreeview.cpp.
QgsMapLayer * QgsLayerTreeView::currentLayer | ( | ) | const |
Returns the currently selected layer, or nullptr
if no layers is selected.
Definition at line 143 of file qgslayertreeview.cpp.
|
signal |
Emitted when a current layer is changed.
QgsLayerTreeModelLegendNode * QgsLayerTreeView::currentLegendNode | ( | ) | const |
Gets current legend node.
May be nullptr
if current node is not a legend node.
Definition at line 416 of file qgslayertreeview.cpp.
QgsLayerTreeNode * QgsLayerTreeView::currentNode | ( | ) | const |
Gets current node. May be nullptr
.
Definition at line 389 of file qgslayertreeview.cpp.
|
signal |
Emitted when datasets are dropped onto the layer tree view.
QgsLayerTreeViewDefaultActions * QgsLayerTreeView::defaultActions | ( | ) |
Gets access to the default actions that may be used with the tree view.
Definition at line 130 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 647 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 661 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 675 of file qgslayertreeview.cpp.
|
slot |
Enhancement of QTreeView::expandAll() that also records expanded state in layer tree nodes.
Definition at line 562 of file qgslayertreeview.cpp.
QgsLayerTreeModelLegendNode * QgsLayerTreeView::index2legendNode | ( | const QModelIndex & | index | ) | const |
Returns legend node for given proxy model tree index.
Returns nullptr
for invalid index
Unlike QgsLayerTreeModel::index2legendNode(), calling this method correctly accounts for mapping the view indexes through the view's proxy model to the source model.
Definition at line 784 of file qgslayertreeview.cpp.
QgsLayerTreeNode * QgsLayerTreeView::index2node | ( | const QModelIndex & | index | ) | const |
Returns layer tree node for given proxy model tree index.
Returns root node for invalid index. Returns nullptr
if index does not refer to a layer tree node (e.g. it is a legend node)
Unlike QgsLayerTreeModel::index2Node(), calling this method correctly accounts for mapping the view indexes through the view's proxy model to the source model.
Definition at line 769 of file qgslayertreeview.cpp.
QList< QgsLayerTreeViewIndicator * > QgsLayerTreeView::indicators | ( | QgsLayerTreeNode * | node | ) | const |
Returns list of indicators associated with a particular layer tree node.
Definition at line 509 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 619 of file qgslayertreeview.cpp.
|
protected |
Definition at line 367 of file qgslayertreeview.cpp.
|
inline |
Returns width of contextual menu mark, at right of layer node items.
Definition at line 320 of file qgslayertreeview.h.
QgsLayerTreeModel * QgsLayerTreeView::layerTreeModel | ( | ) | const |
Gets access to the model casted to QgsLayerTreeModel.
Definition at line 125 of file qgslayertreeview.cpp.
QModelIndex QgsLayerTreeView::legendNode2index | ( | QgsLayerTreeModelLegendNode * | legendNode | ) |
Returns proxy model index for a given legend node.
If the legend node does not belong to the layer tree, the result is undefined. If the legend node is belongs to the tree but it is filtered out, invalid model index is returned.
Unlike QgsLayerTreeModel::legendNode2index(), calling this method correctly accounts for mapping the view indexes through the view's proxy model to the source model.
Definition at line 789 of file qgslayertreeview.cpp.
QModelIndex QgsLayerTreeView::legendNode2sourceIndex | ( | QgsLayerTreeModelLegendNode * | legendNode | ) |
Returns index for a given legend node.
If the legend node does not belong to the layer tree, the result is undefined. If the legend node is belongs to the tree but it is filtered out, invalid model index is returned.
Definition at line 794 of file qgslayertreeview.cpp.
|
inline |
Returns pointer to the context menu provider. May be nullptr
.
Definition at line 203 of file qgslayertreeview.h.
|
protectedslot |
Definition at line 194 of file qgslayertreeview.cpp.
|
protectedslot |
Definition at line 265 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 604 of file qgslayertreeview.cpp.
QModelIndex QgsLayerTreeView::node2index | ( | QgsLayerTreeNode * | node | ) | const |
Returns proxy model index for a given node.
If the node does not belong to the layer tree, the result is undefined
Unlike QgsLayerTreeModel::node2index(), calling this method correctly accounts for mapping the view indexes through the view's proxy model to the source model.
Definition at line 774 of file qgslayertreeview.cpp.
QModelIndex QgsLayerTreeView::node2sourceIndex | ( | QgsLayerTreeNode * | node | ) | const |
Returns source model index for a given node.
If the node does not belong to the layer tree, the result is undefined
Definition at line 779 of file qgslayertreeview.cpp.
|
protectedslot |
Definition at line 296 of file qgslayertreeview.cpp.
|
protectedslot |
Definition at line 328 of file qgslayertreeview.cpp.
|
protectedslot |
Definition at line 351 of file qgslayertreeview.cpp.
QgsLayerTreeProxyModel * QgsLayerTreeView::proxyModel | ( | ) | const |
Returns the proxy model used by the view.
This can be used to set filters controlling which layers are shown in the view.
Definition at line 764 of file qgslayertreeview.cpp.
|
slot |
Force refresh of layer symbology. Normally not needed as the changes of layer's renderer are monitored by the model.
Definition at line 521 of file qgslayertreeview.cpp.
void QgsLayerTreeView::removeIndicator | ( | QgsLayerTreeNode * | node, |
QgsLayerTreeViewIndicator * | indicator | ||
) |
Removes a previously added indicator to a layer tree node.
Does not delete the indicator.
Definition at line 503 of file qgslayertreeview.cpp.
|
overrideprotected |
Definition at line 701 of file qgslayertreeview.cpp.
QList< QgsLayerTreeLayer * > QgsLayerTreeView::selectedLayerNodes | ( | ) | const |
Returns the list of selected nodes filtered to just layer nodes (QgsLayerTreeLayer).
Definition at line 432 of file qgslayertreeview.cpp.
QList< QgsMapLayer * > QgsLayerTreeView::selectedLayers | ( | ) | const |
Returns the list of selected layers.
Definition at line 445 of file qgslayertreeview.cpp.
QList< QgsMapLayer * > QgsLayerTreeView::selectedLayersRecursive | ( | ) | const |
Gets list of selected layers, including those that are not directly selected, but their ancestor groups is selected.
If we have a group with two layers L1, L2 and just the group node is selected, this method returns L1 and L2, while selectedLayers() returns an empty list.
Definition at line 475 of file qgslayertreeview.cpp.
QList< QgsLayerTreeModelLegendNode * > QgsLayerTreeView::selectedLegendNodes | ( | ) | const |
Returns the list of selected legend nodes.
Definition at line 458 of file qgslayertreeview.cpp.
QList< QgsLayerTreeNode * > QgsLayerTreeView::selectedNodes | ( | bool | skipInternal = false | ) | const |
Returns the list of selected layer tree nodes.
skipInternal | If true , will ignore nodes which have an ancestor in the selection |
Definition at line 421 of file qgslayertreeview.cpp.
void QgsLayerTreeView::setCurrentLayer | ( | QgsMapLayer * | layer | ) |
Sets the currently selected layer.
If layer is nullptr
then all layers will be deselected.
Definition at line 148 of file qgslayertreeview.cpp.
|
inlineslot |
Set width of contextual menu mark, at right of layer node items.
Definition at line 358 of file qgslayertreeview.h.
void QgsLayerTreeView::setLayerVisible | ( | QgsMapLayer * | layer, |
bool | visible | ||
) |
Convenience methods which sets the visible state of the specified map layer.
Definition at line 163 of file qgslayertreeview.cpp.
void QgsLayerTreeView::setMenuProvider | ( | QgsLayerTreeViewMenuProvider * | menuProvider | ) |
Sets provider for context menu. Takes ownership of the instance.
Definition at line 137 of file qgslayertreeview.cpp.
|
slot |
Set the message bar to display messages from the layer tree.
Definition at line 576 of file qgslayertreeview.cpp.
|
override |
Overridden setModel() from base class. Only QgsLayerTreeModel is an acceptable model.
Definition at line 82 of file qgslayertreeview.cpp.
|
slot |
Set the show private layers to showPrivate.
Definition at line 593 of file qgslayertreeview.cpp.
|
slot |
Returns the show private layers status.
Definition at line 599 of file qgslayertreeview.cpp.
|
protected |
Definition at line 357 of file qgslayertreeview.cpp.
|
protectedslot |
Definition at line 271 of file qgslayertreeview.cpp.
|
friend |
Definition at line 454 of file qgslayertreeview.h.
|
protected |
Keeps track of current layer ID (to check when to emit signal about change of current layer)
Definition at line 434 of file qgslayertreeview.h.
|
protected |
helper class with default actions. Lazily initialized.
Definition at line 430 of file qgslayertreeview.h.
|
protected |
Storage of indicators used with the tree view.
Definition at line 436 of file qgslayertreeview.h.
|
protected |
Used by the item delegate for identification of which indicator has been clicked.
Definition at line 438 of file qgslayertreeview.h.
|
protected |
Width of contextual menu mark for layer nodes.
Definition at line 441 of file qgslayertreeview.h.
|
protected |
Context menu provider. Owned by the view.
Definition at line 432 of file qgslayertreeview.h.