WebEngineDownloadRequest QML Type
Liefert Informationen über einen Download. Mehr...
| Import Statement: | import QtWebEngine |
| In C++: | QWebEngineDownloadRequest |
Eigenschaften
- downloadDirectory : string
- downloadFileName : string
- id : int
- interruptReason : enumeration
- interruptReasonString : string
- isFinished : bool
- isPaused : bool
- isSavePageDownload : bool
- mimeType : string
- receivedBytes : int
- savePageFormat : enumeration
- state : enumeration
- suggestedFileName : string
- totalBytes : int
- url : url
- view : WebEngineView
Methoden
Detaillierte Beschreibung
WebEngineDownloadRequest modelliert einen Download während seines gesamten Lebenszyklus, beginnend mit einer anstehenden Download-Anforderung und endend mit einem abgeschlossenen Download. Es kann zum Beispiel verwendet werden, um Informationen über neue Downloads zu erhalten, den Fortschritt zu überwachen und Downloads anzuhalten, fortzusetzen und abzubrechen.
Downloads werden in der Regel durch Benutzerinteraktionen auf einer Webseite ausgelöst. Es liegt in der Verantwortung von WebEngineProfile, die Anwendung über neue Download-Anforderungen zu informieren. Dazu wird das Signal downloadRequested zusammen mit einer neu erstellten WebEngineDownloadRequest ausgegeben. Die Anwendung kann dann dieses Element prüfen und entscheiden, ob sie es annimmt oder nicht. Damit Qt WebEngine tatsächlich mit dem Herunterladen und Schreiben von Daten auf die Festplatte beginnt, muss ein Signalhandler das Element explizit accept() aufrufen. Wenn kein Signalhandler accept() aufruft, wird die Download-Anforderung automatisch abgelehnt und es wird nichts auf die Festplatte geschrieben.
Hinweis: Einige Eigenschaften, wie die path, unter der die Datei gespeichert wird, können nur vor dem Aufruf von accept() geändert werden.
Lebenszyklus von Objekten
Alle Objekte sind garantiert gültig, solange das Signal downloadRequested gesendet wird. Wird accept() von keinem Signalhandler aufgerufen, so wird das Element unmittelbar nach der Signalausgabe gelöscht. Dies bedeutet, dass die Anwendung keine Verweise auf abgelehnte Download-Elemente aufbewahren darf.
Downloads von Webseiten
Zusätzlich zu normalen Dateidownloads, bei denen einfach nur einige rohe Bytes aus dem Netz abgerufen und auf die Festplatte geschrieben werden, unterstützt Qt WebEngine auch das Speichern kompletter Webseiten, was das Parsen des HTML der Seite, das Herunterladen aller abhängigen Ressourcen und möglicherweise das Verpacken des Ganzen in ein spezielles Dateiformat (savePageFormat) beinhaltet. Um zu prüfen, ob es sich bei einem Download um eine Datei oder eine Webseite handelt, verwenden Sie isSavePageDownload.
Siehe auch WebEngineProfile, WebEngineProfile::downloadRequested, und WebEngineProfile::downloadFinished.
Eigenschaft Dokumentation
downloadDirectory : string |
Enthält den vollständigen Zielpfad ohne Dateinamen, in den die Daten heruntergeladen werden.
Das Download-Verzeichnis kann nur im Handler downloadRequested festgelegt werden, bevor der Download akzeptiert wird.
Siehe auch WebEngineProfile::downloadRequested() und accept().
downloadFileName : string |
Enthält den Namen der Datei, in die die Daten heruntergeladen werden.
Der Name der Download-Datei kann nur im downloadRequested Handler gesetzt werden, bevor der Download akzeptiert wird.
Siehe auch WebEngineProfile::downloadRequested() und accept().
id : int |
Enthält die ID des heruntergeladenen Elements.
interruptReason : enumeration |
Gibt den Grund zurück, warum der Download unterbrochen wurde:
| Konstante | Beschreibung |
|---|---|
WebEngineDownloadRequest.NoReason | Unbekannter Grund oder nicht unterbrochen. |
WebEngineDownloadRequest.FileFailed | Allgemeiner Fehler bei der Dateioperation. |
WebEngineDownloadRequest.FileAccessDenied | Die Datei kann aufgrund von Zugriffsbeschränkungen nicht lokal geschrieben werden. |
WebEngineDownloadRequest.FileNoSpace | Unzureichender Speicherplatz auf dem Ziellaufwerk. |
WebEngineDownloadRequest.FileNameTooLong | Der Verzeichnis- oder Dateiname ist zu lang. |
WebEngineDownloadRequest.FileTooLarge | Die Dateigröße überschreitet die Begrenzung des Dateisystems. |
WebEngineDownloadRequest.FileVirusInfected | Die Datei ist mit einem Virus infiziert. |
WebEngineDownloadRequest.FileTransientError | Vorübergehendes Problem (z. B. die Datei ist in Gebrauch, der Speicherplatz ist erschöpft, oder es sind zu viele Dateien gleichzeitig geöffnet). |
WebEngineDownloadRequest.FileBlocked | Die Datei wurde aufgrund einer lokalen Richtlinie blockiert. |
WebEngineDownloadRequest.FileSecurityCheckFailed | Ein Versuch, die Sicherheit des Downloads zu überprüfen, ist aus unerwarteten Gründen fehlgeschlagen. |
WebEngineDownloadRequest.FileTooShort | Beim Öffnen einer Datei wurde versucht, über das Ende der Datei hinaus zu suchen (im Rahmen der Wiederaufnahme eines zuvor unterbrochenen Downloads). |
WebEngineDownloadRequest.FileHashMismatch | Die Teildatei stimmte nicht mit dem erwarteten Hash überein. |
WebEngineDownloadRequest.NetworkFailed | Allgemeine Netzwerkstörung. |
WebEngineDownloadRequest.NetworkTimeout | Die Netzwerkoperation hat eine Zeitüberschreitung verursacht. |
WebEngineDownloadRequest.NetworkDisconnected | Die Netzwerkverbindung wurde unterbrochen. |
WebEngineDownloadRequest.NetworkServerDown | Der Server ist ausgefallen. |
WebEngineDownloadRequest.NetworkInvalidRequest | Die Netzwerkanforderung war ungültig (z. B. ist die ursprüngliche oder umgeleitete URL ungültig, hat ein nicht unterstütztes Schema oder ist durch eine Richtlinie nicht zulässig). |
WebEngineDownloadRequest.ServerFailed | Allgemeiner Serverausfall. |
WebEngineDownloadRequest.ServerBadContent | Der Server verfügt nicht über die angeforderten Daten. |
WebEngineDownloadRequest.ServerUnauthorized | Der Server hat den Zugriff auf die Ressource nicht autorisiert. |
WebEngineDownloadRequest.ServerCertProblem | Es ist ein Problem mit dem Serverzertifikat aufgetreten. |
WebEngineDownloadRequest.ServerForbidden | Der Zugriff wurde vom Server verboten. |
WebEngineDownloadRequest.ServerUnreachable | Unerwartete Serverantwort (kann darauf hinweisen, dass der antwortende Server nicht der beabsichtigte Server ist). |
WebEngineDownloadRequest.UserCanceled | Der Benutzer hat den Download abgebrochen. |
Siehe auch interruptReasonString.
interruptReasonString : string |
Gibt eine von Menschen lesbare Beschreibung des Grundes für die Unterbrechung des Downloads zurück.
Siehe auch interruptReason.
isFinished : bool |
Ob dieser Download beendet ist (abgeschlossen, abgebrochen oder nicht wiederaufnehmbarer unterbrochener Zustand).
isSavePageDownload : bool |
Ob es sich um eine Download-Anforderung zum Speichern einer Webseite oder einer Datei handelt.
Siehe auch savePageFormat.
mimeType : string |
Enthält den MIME-Typ des Downloads.
receivedBytes : int |
Enthält die Datenmenge in Bytes, die bisher heruntergeladen wurde.
savePageFormat : enumeration |
Beschreibt das Format, das zum Speichern einer Webseite verwendet wird.
| Konstante | Beschreibung |
|---|---|
WebEngineDownloadRequest.UnknownSaveFormat | Dies ist keine Anforderung zum Herunterladen einer kompletten Webseite. |
WebEngineDownloadRequest.SingleHtmlSaveFormat | Die Seite wird als einzelne HTML-Seite gespeichert. Ressourcen, wie z. B. Bilder, werden nicht gespeichert. |
WebEngineDownloadRequest.CompleteHtmlSaveFormat | Die Seite wird als vollständige HTML-Seite gespeichert, z. B. ein Verzeichnis, das die einzelne HTML-Seite und die Ressourcen enthält. |
WebEngineDownloadRequest.MimeHtmlSaveFormat | Die Seite wird als komplette Web-Seite im MIME-HTML-Format gespeichert. |
state : enumeration |
Beschreibt den Status des Downloads:
| Konstante | Beschreibung |
|---|---|
WebEngineDownloadRequest.DownloadRequested | Der Download wurde angefordert, aber noch nicht angenommen. |
WebEngineDownloadRequest.DownloadInProgress | Der Download ist im Gange. |
WebEngineDownloadRequest.DownloadCompleted | Der Download wurde erfolgreich abgeschlossen. |
WebEngineDownloadRequest.DownloadCancelled | Der Download wurde vom Benutzer abgebrochen. |
WebEngineDownloadRequest.DownloadInterrupted | Der Download wurde unterbrochen (durch den Server oder wegen einer Verbindungsunterbrechung). |
suggestedFileName : string |
Gibt den vorgeschlagenen Dateinamen zurück.
totalBytes : int |
Gibt die Gesamtmenge der herunterzuladenden Daten in Bytes an.
-1 bedeutet, dass die Gesamtgröße unbekannt ist.
url : url |
Gibt die Ursprungs-URL des Downloads zurück.
view : WebEngineView |
Gibt die Ansicht zurück, in der der Download angefordert wurde. Wenn der Download nicht durch einen Inhalt in einer Ansicht ausgelöst wurde, wird nullptr zurückgegeben.
Siehe auch WebEngineView.
Dokumentation der Methode
void accept() |
Nimmt die Download-Anforderung an, wodurch der Download gestartet wird.
Befindet sich das Element im Zustand DownloadRequested, geht es in den Zustand DownloadInProgress über und das Herunterladen beginnt. Befindet sich das Objekt in einem anderen Zustand, geschieht nichts.
Siehe auch state.
void cancel() |
Bricht das Herunterladen ab.
Wenn sich das Objekt im Zustand DownloadInProgress befindet, geht es in den Zustand DownloadCancelled über, das Herunterladen wird gestoppt, und teilweise heruntergeladene Dateien werden von der Festplatte gelöscht.
Wenn sich das Objekt im Status DownloadCompleted befindet, geschieht nichts. Befindet sich das Objekt in einem anderen Zustand, so geht es ohne weitere Folgen in den Zustand DownloadCancelled über.
Siehe auch state.
void pause() |
void resume() |
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
