Class: QgsFileDownloaderDialog

class qgis.gui.QgsFileDownloaderDialog(url: QUrl, outputFileName: str, authcfg: str = '')

Bases: PyQt5.QtWidgets.QProgressDialog


  • url (QUrl) – the download url

  • outputFileName (str) – file name where the downloaded content will be stored

  • authcfg (str = '') – optionally apply this authentication configuration

QgsFileDownloaderDialog is a QProgressDialog subclass which handles file downloads and user feedback.

Internally, it uses QgsFileDownloader to handle the download, while showing progress via a progress dialog and supporting cancellation.


Until QGIS 3.0 this functionality was available via QgsFileDownloader.

actionEvent(self, QActionEvent)
changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
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)

Emitted when the download was canceled by the user [signal]


Emitted when the download has completed successfully [signal]


Emitted when an error makes the download fail [signal]


errorMessages (Iterable[str]) –


Emitted always when the downloader exits [signal]


Emitted when data are ready to be processed [signal]

  • bytesReceived (int) –

  • bytesTotal (int) –

dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
event(self, QEvent) → bool
eventFilter(self, QObject, QEvent) → bool
focusInEvent(self, QFocusEvent)
focusNextChild(self) → bool
focusNextPrevChild(self, bool) → bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) → bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) → bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
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]
paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL) → int
resizeEvent(self, QResizeEvent)
sender(self) → QObject
senderSignalIndex(self) → int
sharedPainter(self) → QPainter
showEvent(self, QShowEvent)
tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
wheelEvent(self, QWheelEvent)