WebEngineDownloadRequest QML Type
Fournit des informations sur un téléchargement. Plus d'informations...
| Import Statement: | import QtWebEngine |
| In C++: | QWebEngineDownloadRequest |
Propriétés
- 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
Méthodes
Description détaillée
WebEngineDownloadRequest modélise un téléchargement tout au long de son cycle de vie, en commençant par une demande de téléchargement en attente et en terminant par un téléchargement terminé. Il peut être utilisé, par exemple, pour obtenir des informations sur les nouveaux téléchargements, pour surveiller la progression et pour mettre en pause, reprendre et annuler les téléchargements.
Les téléchargements sont généralement déclenchés par l'interaction de l'utilisateur avec une page web. Il incombe à WebEngineProfile d'informer l'application des nouvelles demandes de téléchargement, ce qu'il fait en émettant le signal downloadRequested en même temps qu'un WebEngineDownloadRequest nouvellement créé. L'application peut alors examiner cet élément et décider de l'accepter ou non. Un gestionnaire de signal doit explicitement appeler accept() sur l'élément pour que Qt WebEngine commence effectivement à télécharger et à écrire des données sur le disque. Si aucun gestionnaire de signal n'appelle accept(), la demande de téléchargement sera automatiquement rejetée et rien ne sera écrit sur le disque.
Remarque : certaines propriétés, comme le chemin sous lequel le fichier sera enregistré, ne peuvent être modifiées qu'avant l'appel à accept().
Cycle de vie des objets
La validité de tous les objets est garantie pendant l'émission du signal downloadRequested. Si accept() n' est pas appelé par un gestionnaire de signal, l'élément sera supprimé immédiatement après l'émission du signal. Cela signifie que l'application ne doit pas conserver de références à des éléments de téléchargement rejetés.
Téléchargements de pages web
Outre les téléchargements de fichiers normaux, qui consistent simplement à récupérer des octets bruts sur le réseau et à les écrire sur le disque, Qt WebEngine prend également en charge l'enregistrement de pages web complètes, ce qui implique d'analyser le code HTML de la page, de télécharger toutes les ressources dépendantes et, éventuellement, d'emballer le tout dans un format de fichier spécial (savePageFormat). Pour vérifier si un téléchargement concerne un fichier ou une page web, utilisez isSavePageDownload.
Voir également WebEngineProfile, WebEngineProfile::downloadRequested, et WebEngineProfile::downloadFinished.
Documentation sur les propriétés
downloadDirectory : string
Indique le chemin d'accès complet (sans nom de fichier) vers lequel les données sont téléchargées.
Le répertoire de téléchargement ne peut être défini que dans le gestionnaire downloadRequested avant que le téléchargement ne soit accepté.
Voir également WebEngineProfile::downloadRequested() et accept().
downloadFileName : string
Contient le nom du fichier dans lequel les données sont téléchargées.
Le nom du fichier de téléchargement ne peut être défini que dans le gestionnaire downloadRequested avant que le téléchargement ne soit accepté.
Voir également WebEngineProfile::downloadRequested() et accept().
id : int [read-only]
Contient l'identifiant de l'élément à télécharger.
interruptReason : enumeration [read-only]
Renvoie la raison pour laquelle le téléchargement a été interrompu :
| Constante | Description |
|---|---|
WebEngineDownloadRequest.NoReason | Raison inconnue ou non interrompu. |
WebEngineDownloadRequest.FileFailed | Échec général de l'opération sur le fichier. |
WebEngineDownloadRequest.FileAccessDenied | Le fichier ne peut pas être écrit localement en raison de restrictions d'accès. |
WebEngineDownloadRequest.FileNoSpace | Espace insuffisant sur le lecteur cible. |
WebEngineDownloadRequest.FileNameTooLong | Le nom du répertoire ou du fichier est trop long. |
WebEngineDownloadRequest.FileTooLarge | La taille du fichier dépasse les limites du système de fichiers. |
WebEngineDownloadRequest.FileVirusInfected | Le fichier est infecté par un virus. |
WebEngineDownloadRequest.FileTransientError | Problème temporaire (par exemple, le fichier est en cours d'utilisation, il n'y a plus de mémoire ou trop de fichiers sont ouverts en même temps). |
WebEngineDownloadRequest.FileBlocked | Le fichier a été bloqué en raison d'une politique locale. |
WebEngineDownloadRequest.FileSecurityCheckFailed | Une tentative de vérification de la sécurité du téléchargement a échoué pour des raisons inattendues. |
WebEngineDownloadRequest.FileTooShort | Une tentative a été faite pour chercher au-delà de la fin d'un fichier lors de l'ouverture d'un fichier (dans le cadre de la reprise d'un téléchargement précédemment interrompu). |
WebEngineDownloadRequest.FileHashMismatch | Le fichier partiel ne correspondait pas au hachage attendu. |
WebEngineDownloadRequest.NetworkFailed | Défaillance générale du réseau. |
WebEngineDownloadRequest.NetworkTimeout | L'opération réseau a dépassé le temps imparti. |
WebEngineDownloadRequest.NetworkDisconnected | La connexion réseau a été interrompue. |
WebEngineDownloadRequest.NetworkServerDown | Le serveur est hors service. |
WebEngineDownloadRequest.NetworkInvalidRequest | La requête réseau n'était pas valide (par exemple, l'URL originale ou redirigée n'est pas valide, a un schéma non pris en charge ou n'est pas autorisée par la politique). |
WebEngineDownloadRequest.ServerFailed | Défaillance générale du serveur. |
WebEngineDownloadRequest.ServerBadContent | Le serveur ne dispose pas des données demandées. |
WebEngineDownloadRequest.ServerUnauthorized | Le serveur n'a pas autorisé l'accès à la ressource. |
WebEngineDownloadRequest.ServerCertProblem | Un problème est survenu avec le certificat du serveur. |
WebEngineDownloadRequest.ServerForbidden | Accès interdit par le serveur. |
WebEngineDownloadRequest.ServerUnreachable | Réponse inattendue du serveur (peut indiquer que le serveur qui répond n'est peut-être pas le serveur prévu). |
WebEngineDownloadRequest.UserCanceled | L'utilisateur a annulé le téléchargement. |
Voir aussi interruptReasonString.
interruptReasonString : string [read-only]
Renvoie une description lisible par l'homme de la raison de l'interruption du téléchargement.
Voir aussi interruptReason.
isFinished : bool [read-only]
Indique si le téléchargement est terminé (achevé, annulé ou interrompu sans possibilité de remise à zéro).
isPaused : bool [read-only]
Si ce téléchargement est interrompu.
isSavePageDownload : bool [read-only]
S'il s'agit d'une demande de téléchargement pour l'enregistrement d'une page web ou d'un fichier.
Voir aussi savePageFormat.
mimeType : string [read-only]
Contient le type MIME du téléchargement.
receivedBytes : int [read-only]
Contient la quantité de données en octets qui ont été téléchargées jusqu'à présent.
savePageFormat : enumeration
Décrit le format utilisé pour enregistrer une page web.
| Constante | Description |
|---|---|
WebEngineDownloadRequest.UnknownSaveFormat | Il ne s'agit pas d'une demande de téléchargement d'une page web complète. |
WebEngineDownloadRequest.SingleHtmlSaveFormat | La page est enregistrée en tant que page HTML unique. Les ressources telles que les images ne sont pas enregistrées. |
WebEngineDownloadRequest.CompleteHtmlSaveFormat | La page est enregistrée en tant que page HTML complète, par exemple un répertoire contenant la page HTML unique et les ressources. |
WebEngineDownloadRequest.MimeHtmlSaveFormat | La page est enregistrée en tant que page web complète au format MIME HTML. |
state : enumeration [read-only]
Décrit l'état du téléchargement :
| Constant | Description de l'état du téléchargement |
|---|---|
WebEngineDownloadRequest.DownloadRequested | Le téléchargement a été demandé, mais il n'a pas encore été accepté. |
WebEngineDownloadRequest.DownloadInProgress | Le téléchargement est en cours. |
WebEngineDownloadRequest.DownloadCompleted | Le téléchargement s'est terminé avec succès. |
WebEngineDownloadRequest.DownloadCancelled | Le téléchargement a été annulé par l'utilisateur. |
WebEngineDownloadRequest.DownloadInterrupted | Le téléchargement a été interrompu (par le serveur ou en raison d'une perte de connectivité). |
suggestedFileName : string [read-only]
Renvoie le nom de fichier suggéré.
totalBytes : int [read-only]
Indique la quantité totale de données à télécharger en octets.
-1 signifie que la taille totale est inconnue.
url : url [read-only]
Renvoie l'URL d'origine du téléchargement.
view : WebEngineView [read-only]
Renvoie la vue sur laquelle le téléchargement a été demandé. Si le téléchargement n'a pas été déclenché par le contenu d'une vue, nullptr est renvoyé.
Voir aussi WebEngineView.
Documentation de la méthode
void accept()
Accepte la demande de téléchargement, ce qui lancera le téléchargement.
Si l'élément est dans l'état DownloadRequested, il passera dans l'état DownloadInProgress et le téléchargement commencera. Si l'élément est dans un autre état, il ne se passera rien.
Voir aussi state.
void cancel()
Annule le téléchargement.
Si l'élément est dans l'état DownloadInProgress, il passera dans l'état DownloadCancelled, le téléchargement s'arrêtera et les fichiers partiellement téléchargés seront supprimés du disque.
Si l'élément est dans l'état DownloadCompleted, il ne se passera rien. Si l'élément est dans un autre état, il passera à l'état DownloadCancelled sans autre effet.
Voir aussi state.
void pause()
Interrompt le téléchargement.
Sans effet si l'état n'est pas DownloadInProgress. Ne modifie pas l'état.
Voir également resume et isPaused.
void resume()
Reprend le téléchargement s'il a été mis en pause ou interrompu.
N'a aucun effet si l'état n'est pas DownloadInProgress ou DownloadInterrupted. Ne modifie pas l'état.
© 2026 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.
