QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
The QgsMapLayerComboBox class is a combo box which displays the list of layers. More...
#include <qgsmaplayercombobox.h>
Public Slots | |
void | setLayer (QgsMapLayer *layer) |
Sets the current layer selected in the combo box. | |
Signals | |
void | layerChanged (QgsMapLayer *layer) |
Emitted whenever the currently selected layer changes. | |
Public Member Functions | |
QgsMapLayerComboBox (QWidget *parent=nullptr) | |
QgsMapLayerComboBox creates a combo box to display the list of layers (currently in the registry). | |
QStringList | additionalItems () const |
Returns the list of additional (non map layer) items included at the end of the combo box. | |
QList< QgsMapLayer * > | additionalLayers () const |
Returns the list of additional layers added to the combobox. | |
bool | allowEmptyLayer () const |
Returns true if the combo box allows the empty layer ("not set") choice. | |
QgsMapLayer * | currentLayer () const |
Returns the current layer selected in the combo box. | |
QList< QgsMapLayer * > | exceptedLayerList () const |
Returns a list of layers which should be excluded from the combo box. | |
QStringList | excludedProviders () const |
Returns the list of data providers which are excluded from the combobox. | |
Qgis::LayerFilters | filters () const |
Returns any currently used filters on the listed layers. | |
QgsMapLayer * | layer (int layerIndex) const |
Returns the layer currently shown at the specified index within the combo box. | |
void | setAdditionalItems (const QStringList &items) |
Sets a list of additional (non map layer) items to include at the end of the combobox. | |
void | setAdditionalLayers (const QList< QgsMapLayer * > &layers) |
Sets a list of additional layers to include in the combobox. | |
void | setAllowEmptyLayer (bool allowEmpty, const QString &text=QString(), const QIcon &icon=QIcon()) |
Sets whether an optional empty layer ("not set") option is shown in the combo box. | |
void | setExceptedLayerList (const QList< QgsMapLayer * > &layerList) |
Sets a list of layers which should be excluded from the combo box. | |
void | setExcludedProviders (const QStringList &providers) |
Sets a list of data providers which should be excluded from the combobox. | |
Q_DECL_DEPRECATED void | setFilters (int filters) |
Filters according to layer type and/or geometry type. | |
void | setFilters (Qgis::LayerFilters filters) |
Sets filters for the layers displayed in the combo box. | |
void | setProject (QgsProject *project) |
Sets the project from which map layers are shown. | |
void | setShowCrs (bool showCrs) |
Sets whether the CRS of layers is also included in the combo box text. | |
bool | showCrs () const |
Returns true if the combo box shows the layer's CRS. | |
Protected Slots | |
void | indexChanged (int i) |
void | rowsChanged () |
Protected Member Functions | |
void | dragEnterEvent (QDragEnterEvent *event) override |
void | dragLeaveEvent (QDragLeaveEvent *event) override |
void | dropEvent (QDropEvent *event) override |
void | paintEvent (QPaintEvent *e) override |
Properties | |
bool | allowEmptyLayer |
QStringList | excludedProviders |
Qgis::LayerFilters | filters |
bool | showCrs |
Friends | |
class | QgsProcessingMapLayerComboBox |
The QgsMapLayerComboBox class is a combo box which displays the list of layers.
Definition at line 33 of file qgsmaplayercombobox.h.
|
explicit |
QgsMapLayerComboBox creates a combo box to display the list of layers (currently in the registry).
The layers can be filtered and/or ordered.
Definition at line 23 of file qgsmaplayercombobox.cpp.
QStringList QgsMapLayerComboBox::additionalItems | ( | ) | const |
Returns the list of additional (non map layer) items included at the end of the combo box.
Definition at line 79 of file qgsmaplayercombobox.cpp.
QList< QgsMapLayer * > QgsMapLayerComboBox::additionalLayers | ( | ) | const |
Returns the list of additional layers added to the combobox.
Definition at line 89 of file qgsmaplayercombobox.cpp.
bool QgsMapLayerComboBox::allowEmptyLayer | ( | ) | const |
Returns true
if the combo box allows the empty layer ("not set") choice.
Definition at line 59 of file qgsmaplayercombobox.cpp.
QgsMapLayer * QgsMapLayerComboBox::currentLayer | ( | ) | const |
Returns the current layer selected in the combo box.
Definition at line 121 of file qgsmaplayercombobox.cpp.
|
overrideprotected |
Definition at line 183 of file qgsmaplayercombobox.cpp.
|
overrideprotected |
Definition at line 205 of file qgsmaplayercombobox.cpp.
|
overrideprotected |
Definition at line 219 of file qgsmaplayercombobox.cpp.
|
inline |
Returns a list of layers which should be excluded from the combo box.
Definition at line 85 of file qgsmaplayercombobox.h.
QStringList QgsMapLayerComboBox::excludedProviders | ( | ) | const |
Returns the list of data providers which are excluded from the combobox.
Definition at line 49 of file qgsmaplayercombobox.cpp.
|
inline |
Returns any currently used filters on the listed layers.
Definition at line 71 of file qgsmaplayercombobox.h.
|
protectedslot |
Definition at line 148 of file qgsmaplayercombobox.cpp.
QgsMapLayer * QgsMapLayerComboBox::layer | ( | int | layerIndex | ) | const |
Returns the layer currently shown at the specified index within the combo box.
layerIndex | position of layer to return |
Definition at line 126 of file qgsmaplayercombobox.cpp.
|
signal |
Emitted whenever the currently selected layer changes.
|
overrideprotected |
Definition at line 244 of file qgsmaplayercombobox.cpp.
|
protectedslot |
Definition at line 155 of file qgsmaplayercombobox.cpp.
void QgsMapLayerComboBox::setAdditionalItems | ( | const QStringList & | items | ) |
Sets a list of additional (non map layer) items to include at the end of the combobox.
These may represent additional layers such as layers which are not included in the map layer registry, or paths to layers which have not yet been loaded into QGIS.
Definition at line 74 of file qgsmaplayercombobox.cpp.
void QgsMapLayerComboBox::setAdditionalLayers | ( | const QList< QgsMapLayer * > & | layers | ) |
Sets a list of additional layers to include in the combobox.
This method allows adding additional layers, which are not part of a project's layers, into the combobox.
Definition at line 84 of file qgsmaplayercombobox.cpp.
void QgsMapLayerComboBox::setAllowEmptyLayer | ( | bool | allowEmpty, |
const QString & | text = QString() , |
||
const QIcon & | icon = QIcon() |
||
) |
Sets whether an optional empty layer ("not set") option is shown in the combo box.
Since QGIS 3.20, the optional text and icon arguments allows the text and icon for the empty layer item to be set.
Definition at line 54 of file qgsmaplayercombobox.cpp.
|
inline |
Sets a list of layers which should be excluded from the combo box.
Definition at line 78 of file qgsmaplayercombobox.h.
void QgsMapLayerComboBox::setExcludedProviders | ( | const QStringList & | providers | ) |
Sets a list of data providers which should be excluded from the combobox.
Definition at line 38 of file qgsmaplayercombobox.cpp.
|
inline |
Filters according to layer type and/or geometry type.
Definition at line 64 of file qgsmaplayercombobox.h.
|
inline |
Sets filters for the layers displayed in the combo box.
This method allows filtering layers according to layer type and/or geometry type.
Definition at line 56 of file qgsmaplayercombobox.h.
|
slot |
Sets the current layer selected in the combo box.
Definition at line 94 of file qgsmaplayercombobox.cpp.
void QgsMapLayerComboBox::setProject | ( | QgsProject * | project | ) |
Sets the project from which map layers are shown.
If project is nullptr
then QgsProject::instance() will be used.
Definition at line 43 of file qgsmaplayercombobox.cpp.
void QgsMapLayerComboBox::setShowCrs | ( | bool | showCrs | ) |
Sets whether the CRS of layers is also included in the combo box text.
Definition at line 64 of file qgsmaplayercombobox.cpp.
bool QgsMapLayerComboBox::showCrs | ( | ) | const |
Returns true
if the combo box shows the layer's CRS.
Definition at line 69 of file qgsmaplayercombobox.cpp.
|
friend |
Definition at line 215 of file qgsmaplayercombobox.h.
|
readwrite |
Definition at line 37 of file qgsmaplayercombobox.h.
|
readwrite |
Definition at line 39 of file qgsmaplayercombobox.h.
|
readwrite |
Definition at line 36 of file qgsmaplayercombobox.h.
|
readwrite |
Definition at line 38 of file qgsmaplayercombobox.h.