QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
Public Slots | Signals | Public Member Functions | Protected Member Functions | List of all members
QgsBrowserDockWidget Class Reference

The QgsBrowserDockWidget class. More...

#include <qgsbrowserdockwidget.h>

Inheritance diagram for QgsBrowserDockWidget:
Inheritance graph
[legend]

Public Slots

Q_DECL_DEPRECATED void addFavorite ()
 Add current item to favorite. More...
 
Q_DECL_DEPRECATED void addFavoriteDirectory ()
 Add directory from file dialog to favorite. More...
 
Q_DECL_DEPRECATED bool addLayerAtIndex (const QModelIndex &index)
 Adds the layer corresponding to the specified model index. More...
 
void addSelectedLayers ()
 Add selected layers to the project. More...
 
void enablePropertiesWidget (bool enable)
 Enable/disable properties widget. More...
 
void hideItem ()
 Hide current item. More...
 
void refresh ()
 Refresh browser view model (and view) More...
 
Q_DECL_DEPRECATED void removeFavorite ()
 Remove from favorite. More...
 
void selectionChanged (const QItemSelection &selected, const QItemSelection &deselected)
 Selection has changed. More...
 
void setActiveIndex (const QModelIndex &index)
 Sets the selection to index and expand it. More...
 
void setCaseSensitive (bool caseSensitive)
 Sets filter case sensitivity. More...
 
void setFilter ()
 Apply filter to the model. More...
 
void setFilterSyntax (QAction *)
 Sets filter syntax. More...
 
void showContextMenu (QPoint)
 Show context menu. More...
 
void showFilterWidget (bool visible)
 Show/hide filter widget. More...
 
void showProperties ()
 Show the layer properties. More...
 
void splitterMoved ()
 Splitter has been moved. More...
 
Q_DECL_DEPRECATED void toggleFastScan ()
 Toggle fast scan. More...
 
void updateProjectHome ()
 Update project home directory. More...
 
- Public Slots inherited from QgsDockWidget
void setUserVisible (bool visible)
 Sets the dock widget as visible to a user, ie both shown and raised to the front. More...
 
void toggleUserVisible ()
 Toggles whether the dock is user visible. More...
 

Signals

void connectionsChanged ()
 Connections changed in the browser. More...
 
void handleDropUriList (const QgsMimeDataUtils::UriList &)
 Emitted when drop uri list needs to be handled. More...
 
void openFile (const QString &fileName, const QString &fileTypeHint=QString())
 Emitted when a file needs to be opened. More...
 
- Signals inherited from QgsDockWidget
void closed ()
 Emitted when dock widget is closed. More...
 
void closedStateChanged (bool wasClosed)
 Emitted when dock widget is closed (or opened). More...
 
void opened ()
 Emitted when dock widget is opened. More...
 
void openedStateChanged (bool wasOpened)
 Emitted when dock widget is opened (or closed). More...
 

Public Member Functions

 QgsBrowserDockWidget (const QString &name, QgsBrowserGuiModel *browserModel, QWidget *parent=nullptr)
 Constructor for QgsBrowserDockWidget. More...
 
 ~QgsBrowserDockWidget () override
 
Q_DECL_DEPRECATED void addFavoriteDirectory (const QString &favDir, const QString &name=QString())
 Add directory to favorites. More...
 
QgsMessageBarmessageBar ()
 Returns the message bar associated with the dock. More...
 
void setDisabledDataItemsKeys (const QStringList &filter)
 Sets the customization for data items based on item's data provider key. More...
 
void setMessageBar (QgsMessageBar *bar)
 Sets a message bar to use alongside the dock widget. More...
 
- Public Member Functions inherited from QgsDockWidget
 QgsDockWidget (const QString &title, QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
 Constructor for QgsDockWidget. More...
 
 QgsDockWidget (QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
 Constructor for QgsDockWidget. More...
 
bool isUserVisible () const
 Returns true if the dock is both opened and raised to the front (ie not hidden by any other tabs. More...
 
void setToggleVisibilityAction (QAction *action)
 Links an action to the dock, so that toggling the action will automatically set the dock's visibility to suit (and changing the dock visibility will update the action's state). More...
 
QAction * toggleVisibilityAction ()
 Returns the action linked to the dock. More...
 

Protected Member Functions

void showEvent (QShowEvent *event) override
 Show event override. More...
 
- Protected Member Functions inherited from QgsDockWidget
void closeEvent (QCloseEvent *) override
 
void showEvent (QShowEvent *event) override
 

Detailed Description

The QgsBrowserDockWidget class.

Since
QGIS 3.0

Definition at line 43 of file qgsbrowserdockwidget.h.

Constructor & Destructor Documentation

◆ QgsBrowserDockWidget()

QgsBrowserDockWidget::QgsBrowserDockWidget ( const QString &  name,
QgsBrowserGuiModel browserModel,
QWidget *  parent = nullptr 
)
explicit

Constructor for QgsBrowserDockWidget.

Parameters
namename of the widget
browserModelinstance of the (shared) browser model
parentparent widget

Definition at line 48 of file qgsbrowserdockwidget.cpp.

◆ ~QgsBrowserDockWidget()

QgsBrowserDockWidget::~QgsBrowserDockWidget ( )
override

Definition at line 111 of file qgsbrowserdockwidget.cpp.

Member Function Documentation

◆ addFavorite

void QgsBrowserDockWidget::addFavorite ( )
slot

Add current item to favorite.

Deprecated:
will be removed in QGIS 4.0 - use the methods in QgsBrowserModel instead

Definition at line 249 of file qgsbrowserdockwidget.cpp.

◆ addFavoriteDirectory [1/2]

void QgsBrowserDockWidget::addFavoriteDirectory ( )
slot

Add directory from file dialog to favorite.

Deprecated:
will be removed in QGIS 4.0 - use the methods in QgsBrowserModel instead

Definition at line 265 of file qgsbrowserdockwidget.cpp.

◆ addFavoriteDirectory() [2/2]

void QgsBrowserDockWidget::addFavoriteDirectory ( const QString &  favDir,
const QString &  name = QString() 
)

Add directory to favorites.

Deprecated:
will be removed in QGIS 4.0 - use the methods in QgsBrowserModel instead

Definition at line 276 of file qgsbrowserdockwidget.cpp.

◆ addLayerAtIndex

bool QgsBrowserDockWidget::addLayerAtIndex ( const QModelIndex &  index)
slot

Adds the layer corresponding to the specified model index.

Returns true if the index was successfully intrepreted as a map layer and loaded, or false if the index is not a map layer or could not be loaded.

Deprecated:
will be removed in QGIS 4.0 - retrieve the QgsLayerItem itself and manually add to project.

Definition at line 362 of file qgsbrowserdockwidget.cpp.

◆ addSelectedLayers

void QgsBrowserDockWidget::addSelectedLayers ( )
slot

Add selected layers to the project.

Definition at line 392 of file qgsbrowserdockwidget.cpp.

◆ connectionsChanged

void QgsBrowserDockWidget::connectionsChanged ( )
signal

Connections changed in the browser.

◆ enablePropertiesWidget

void QgsBrowserDockWidget::enablePropertiesWidget ( bool  enable)
slot

Enable/disable properties widget.

Definition at line 586 of file qgsbrowserdockwidget.cpp.

◆ handleDropUriList

void QgsBrowserDockWidget::handleDropUriList ( const QgsMimeDataUtils::UriList )
signal

Emitted when drop uri list needs to be handled.

◆ hideItem

void QgsBrowserDockWidget::hideItem ( )
slot

Hide current item.

Definition at line 431 of file qgsbrowserdockwidget.cpp.

◆ messageBar()

QgsMessageBar * QgsBrowserDockWidget::messageBar ( )

Returns the message bar associated with the dock.

See also
setMessageBar()
Since
QGIS 3.6

Definition at line 287 of file qgsbrowserdockwidget.cpp.

◆ openFile

void QgsBrowserDockWidget::openFile ( const QString &  fileName,
const QString &  fileTypeHint = QString() 
)
signal

Emitted when a file needs to be opened.

◆ refresh

void QgsBrowserDockWidget::refresh ( )
slot

Refresh browser view model (and view)

Definition at line 307 of file qgsbrowserdockwidget.cpp.

◆ removeFavorite

void QgsBrowserDockWidget::removeFavorite ( )
slot

Remove from favorite.

Deprecated:
will be removed in QGIS 4.0 - use the methods in QgsBrowserModel instead

Definition at line 302 of file qgsbrowserdockwidget.cpp.

◆ selectionChanged

void QgsBrowserDockWidget::selectionChanged ( const QItemSelection &  selected,
const QItemSelection &  deselected 
)
slot

Selection has changed.

Definition at line 544 of file qgsbrowserdockwidget.cpp.

◆ setActiveIndex

void QgsBrowserDockWidget::setActiveIndex ( const QModelIndex &  index)
slot

Sets the selection to index and expand it.

Definition at line 599 of file qgsbrowserdockwidget.cpp.

◆ setCaseSensitive

void QgsBrowserDockWidget::setCaseSensitive ( bool  caseSensitive)
slot

Sets filter case sensitivity.

Definition at line 520 of file qgsbrowserdockwidget.cpp.

◆ setDisabledDataItemsKeys()

void QgsBrowserDockWidget::setDisabledDataItemsKeys ( const QStringList &  filter)

Sets the customization for data items based on item's data provider key.

By default browser model shows all items from all available data items provider and few special items (e.g. Favorites). To customize the behavior, set the filter to not load certain data items. The items that are not based on data item providers (e.g. Favorites, Home) have prefix "special:"

Used in the proxy browser model to hide items

Since
QGIS 3.12

Definition at line 292 of file qgsbrowserdockwidget.cpp.

◆ setFilter

void QgsBrowserDockWidget::setFilter ( )
slot

Apply filter to the model.

Definition at line 499 of file qgsbrowserdockwidget.cpp.

◆ setFilterSyntax

void QgsBrowserDockWidget::setFilterSyntax ( QAction *  action)
slot

Sets filter syntax.

Definition at line 512 of file qgsbrowserdockwidget.cpp.

◆ setMessageBar()

void QgsBrowserDockWidget::setMessageBar ( QgsMessageBar bar)

Sets a message bar to use alongside the dock widget.

Setting this allows items to utilize the message bar to provide non-blocking feedback to users, e.g. success or failure of actions.

See also
messageBar()
Since
QGIS 3.6

Definition at line 281 of file qgsbrowserdockwidget.cpp.

◆ showContextMenu

void QgsBrowserDockWidget::showContextMenu ( QPoint  pt)
slot

Show context menu.

Definition at line 194 of file qgsbrowserdockwidget.cpp.

◆ showEvent()

void QgsBrowserDockWidget::showEvent ( QShowEvent *  event)
overrideprotected

Show event override.

Definition at line 119 of file qgsbrowserdockwidget.cpp.

◆ showFilterWidget

void QgsBrowserDockWidget::showFilterWidget ( bool  visible)
slot

Show/hide filter widget.

Definition at line 485 of file qgsbrowserdockwidget.cpp.

◆ showProperties

void QgsBrowserDockWidget::showProperties ( )
slot

Show the layer properties.

Definition at line 444 of file qgsbrowserdockwidget.cpp.

◆ splitterMoved

void QgsBrowserDockWidget::splitterMoved ( )
slot

Splitter has been moved.

Definition at line 609 of file qgsbrowserdockwidget.cpp.

◆ toggleFastScan

void QgsBrowserDockWidget::toggleFastScan ( )
slot

Toggle fast scan.

Deprecated:
will be removed in QGIS 4.0

Definition at line 460 of file qgsbrowserdockwidget.cpp.

◆ updateProjectHome

void QgsBrowserDockWidget::updateProjectHome ( )
slot

Update project home directory.

Definition at line 506 of file qgsbrowserdockwidget.cpp.


The documentation for this class was generated from the following files: