DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Téléchargement
  • Propriétés spécifiques à la description des variables de type TéléchargementInfo
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Le type TéléchargementInfo permet de lire des différentes informations concernant un téléchargement en cours récupéré par la fonction TéléchargementRécupèreInfo. Les caractéristiques de ce téléchargement peuvent être connues et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Procédure à appeler en fin de téléchargement
PROCÉDURE FinDeTéléchargement(InfoTéléchargement est un TéléchargementInfo)
SI InfoTéléchargement.Etat = téléchargementEtatSuccès ALORS
Info("Le téléchargement " + InfoTéléchargement.Titre + " est terminé."
RENVOYER Faux
FIN


// ---------------
// Crée une variable de type TéléchargementParamètre 
// pour enregistrer les informations du téléchargement
ParamètreTéléchargement est une TéléchargementParamètre

// Spécifie les paramètres du téléchargement
ParamètreTéléchargement.Source = ...
"https://www.pcsoft.fr/img/visuels/download.php?filename=pcsoft/logo-pcsoft.png"
ParamètreTéléchargement.Titre = "Logo PC Soft"
ParamètreTéléchargement.Description = "Logo de l'entreprise PC Soft."
ParamètreTéléchargement.Destination = SysRepStockageExterne(1, sseAppTéléchargement)
ParamètreTéléchargement.RéseauMobileAutorisé = Vrai
ParamètreTéléchargement.RéseauRestreintAutorisé = Faux
ParamètreTéléchargement.EnCharge = Vrai
ParamètreTéléchargement.ModeNotification = téléchargementNotifProgressionEtFin
// Procédure à appeler en fin de téléchargement
ParamètreTéléchargement.ProcédureFin = "FinDeTéléchargement"

// Le téléchargement est ajouté à la liste des téléchargements à effectuer
// (Le téléchargement commencera dès que le gestionnaire de téléchargement pourra le lancer).
nID est un entier = TéléchargementAjoute(ParamètreTéléchargement)

telInfo est une TéléchargementInfo = TéléchargementRécupèreInfo(nID)

Info(telInfo.Titre)
Remarques

Propriétés spécifiques à la description des variables de type TéléchargementInfo

Les propriétés suivantes peuvent être utilisées pour connaître les informations concernant un téléchargement :
Nom de la propriétéType manipuléEffet
AvancementEntier sur 8 octetsNombre d'octets téléchargés.
DescriptionChaîne de caractèresDescription du téléchargement affichée dans la notification (si cette dernière est activée).
DestinationVariable de type URIAdresse physique à laquelle le fichier doit être enregistré.
EtatConstante de type EntierStatut du téléchargement :
  • téléchargementEtatEchec : Le téléchargement a échoué. La propriété EtatDétail permet d'obtenir plus de renseignements.
  • téléchargementEtatEnAttente : Le téléchargement est en attente.
  • téléchargementEtatEnCours : Le téléchargement est en cours.
  • téléchargementEtatPause : Le téléchargement est en pause. La propriété EtatDétail permet d'obtenir plus de renseignements.
  • téléchargementEtatSuccès : Le téléchargement a réussi.
EtatDétailEntierDétails sur l'état.
Si la propriété Etat correspond à la constante téléchargementEtatEchec, la propriété EtatDétail permet de connaître le code RFC 2616 de l'erreur si celui-ci est reçu.
Dans les autres cas, correspond à une des constantes suivantes :
  • téléchargementErreurEspaceInsuffisant : L'espace de stockage est insuffisant.
  • téléchargementErreurFichierExistant : L'URI pointe vers un fichier existant.
  • téléchargementErreurInconnu : L'erreur n'est pas connue.
  • téléchargementErreurStockage : Erreur liée au stockage.
  • téléchargementPauseAttenteNouvelEssai : La raison de la pause est une erreur réseau, le système attend avant de réessayer.
  • téléchargementPauseAttentePourWifi : La raison de la pause correspond à l'attente d'être en réseau WIFI.
  • téléchargementPauseAttenteRéseau : La raison de la pause correspond à l'attente d'une connexion réseau.
  • téléchargementPauseInconnu : La raison de la pause est inconnue.
IdentifiantEntierIdentifiant du téléchargement dans le gestionnaire de téléchargement.
SourceVariable de type URIAdresse http/https du fichier en cours de téléchargement.
TailleFichierEntier sur 8 octetsTaille du fichier en octets.
TitreChaîne de caractèresTitre du téléchargement affiché dans la notification (si cette dernière est activée).
Liste des exemples associés :
Android Téléchargements Android (WINDEV Mobile) : Android Téléchargements
[ + ] Cet exemple illustre l'usage du téléchargement en arrière-plan disponible dans WINDEV Mobile et Android.
Il n'est donc plus nécessaire de conserver l'application ouverte pour proposer le téléchargement d'un fichier. Le gestionnaire de téléchargement permet de télécharger des fichiers volumineux et permet également de notifier l'application lors de la fin des téléchargements.
Version minimum requise
  • Version 27
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale