Class: QgsBrowserDockWidget

class qgis.gui.QgsBrowserDockWidget(name: str, browserModel: QgsBrowserGuiModel, parent: QWidget = None)

Bases: QgsDockWidget

Constructor for QgsBrowserDockWidget

Parameters
  • name – name of the widget

  • browserModel – instance of the (shared) browser model

  • parent – parent widget

The QgsBrowserDockWidget class

Methods

actionEvent

addFavorite

Add current item to favorite.

addFavoriteDirectory

Add directory to favorites.

addLayerAtIndex

Adds the layer corresponding to the specified model index.

addSelectedLayers

Add selected layers to the project

changeEvent

childEvent

closeEvent

connectNotify

contextMenuEvent

create

customEvent

destroy

disconnectNotify

dragEnterEvent

dragLeaveEvent

dragMoveEvent

dropEvent

enablePropertiesWidget

Enable/disable properties widget

enterEvent

event

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

hideItem

Hide current item

initPainter

initStyleOption

inputMethodEvent

isSignalConnected

keyPressEvent

keyReleaseEvent

leaveEvent

messageBar

Returns the message bar associated with the dock.

metric

mouseDoubleClickEvent

mouseMoveEvent

mousePressEvent

mouseReleaseEvent

moveEvent

nativeEvent

paintEvent

receivers

refresh

Refresh browser view model (and view)

removeFavorite

Remove from favorite.

resizeEvent

selectionChanged

Selection has changed

sender

senderSignalIndex

setActiveIndex

Sets the selection to index and expand it

setCaseSensitive

Sets filter case sensitivity

setDisabledDataItemsKeys

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

setFilter

Apply filter to the model

setFilterSyntax

Sets filter syntax

setMessageBar

Sets a message bar to use alongside the dock widget.

sharedPainter

showContextMenu

Show context menu

showEvent

Show event override

showFilterWidget

Show/hide filter widget

showProperties

Show the layer properties

splitterMoved

Splitter has been moved

tabletEvent

timerEvent

toggleFastScan

Toggle fast scan

updateMicroFocus

updateProjectHome

Update project home directory

wheelEvent

Signals

connectionsChanged

Connections changed in the browser [signal]

handleDropUriList

Emitted when drop uri list needs to be handled [signal]

openFile

Emitted when a file needs to be opened [signal]

actionEvent(self, QActionEvent)
addFavorite(self)

Add current item to favorite.

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

addFavoriteDirectory(self, favDir: str, name: str = '')

Add directory to favorites.

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

addFavoriteDirectory(self) Add directory from file dialog to favorite.

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

Parameters
  • favDir (str) –

  • name (str = '') –

addLayerAtIndex(self, index: QModelIndex)bool

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 since version will: be removed in QGIS 4.0 - retrieve the QgsLayerItem itself and manually add to project.

Parameters

index (QModelIndex) –

Return type

bool

addSelectedLayers(self)

Add selected layers to the project

changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
connectionsChanged

Connections changed in the browser [signal]

contextMenuEvent(self, QContextMenuEvent)
create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enablePropertiesWidget(self, enable: bool)

Enable/disable properties widget

Parameters

enable (bool) –

enterEvent(self, QEvent)
event(self, QEvent)bool
focusInEvent(self, QFocusEvent)
focusNextChild(self)bool
focusNextPrevChild(self, bool)bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self)bool
handleDropUriList

Emitted when drop uri list needs to be handled [signal]

hideEvent(self, QHideEvent)
hideItem(self)

Hide current item

initPainter(self, QPainter)
initStyleOption(self, QStyleOptionDockWidget)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod)bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
messageBar(self)QgsMessageBar

Returns the message bar associated with the dock.

See also

setMessageBar()

New in version 3.6.

Return type

QgsMessageBar

metric(self, QPaintDevice.PaintDeviceMetric)int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr)Tuple[bool, int]
openFile

Emitted when a file needs to be opened [signal]

Parameters
  • fileName (str) –

  • fileTypeHint (str = '') –

paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL)int
refresh(self)

Refresh browser view model (and view)

removeFavorite(self)

Remove from favorite.

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

resizeEvent(self, QResizeEvent)
selectionChanged(self, selected: QItemSelection, deselected: QItemSelection)

Selection has changed

Parameters
  • selected (QItemSelection) –

  • deselected (QItemSelection) –

sender(self)QObject
senderSignalIndex(self)int
setActiveIndex(self, index: QModelIndex)

Sets the selection to index and expand it

Parameters

index (QModelIndex) –

setCaseSensitive(self, caseSensitive: bool)

Sets filter case sensitivity

Parameters

caseSensitive (bool) –

setDisabledDataItemsKeys(self, filter: Iterable[str])

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

New in version 3.12.

Parameters

filter (Iterable[str]) –

setFilter(self)

Apply filter to the model

setFilterSyntax(self, QAction)

Sets filter syntax

setMessageBar(self, bar: QgsMessageBar)

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()

New in version 3.6.

Parameters

bar (QgsMessageBar) –

sharedPainter(self)QPainter
showContextMenu(self, QPoint)

Show context menu

showEvent(self, event: QShowEvent)

Show event override

Parameters

event (QShowEvent) –

showFilterWidget(self, visible: bool)

Show/hide filter widget

Parameters

visible (bool) –

showProperties(self)

Show the layer properties

splitterMoved(self)

Splitter has been moved

tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
toggleFastScan(self)

Toggle fast scan

Deprecated since version will: be removed in QGIS 4.0

updateMicroFocus(self)
updateProjectHome(self)

Update project home directory

wheelEvent(self, QWheelEvent)