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échargementParamètre
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échargementParamètre permet de définir toutes les caractéristiques avancées d'un téléchargement de fichier qui sera réalisé par la fonction TéléchargementAjoute. Les caractéristiques de ce téléchargement peuvent être définies 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échargementParamètre

Les propriétés suivantes peuvent être utilisées pour manipuler les caractéristiques d'un téléchargement :
Nom de la propriétéType manipuléEffet
DescriptionChaîne de caractèresDescription du téléchargement affichée dans la notification (si cette dernière est activée).
Remarque : Cette propriété est optionnelle.
DestinationChaîne de caractèresAdresse physique à laquelle le fichier doit être enregistré. Le chemin doit correspondre :
  • soit au stockage externe du terminal,
  • soit aux dossiers appartenant à l'application,
  • soit au dossier de téléchargement public, accessible grâce à la fonction SysRepStockageExterne utilisée avec la fonction ssePublicTéléchargement.
Si aucune destination n'est spécifiée ou si cette propriété correspond à une chaîne vide, le fichier sera téléchargé dans le dossier de téléchargement public du terminal.
Remarque : Cette propriété est optionnelle.
EnChargeBooléen
  • Vrai si le téléchargement nécessite que le téléphone soit en train de charger,
  • Faux (valeur par défaut) dans le cas contraire.
EntêteTableau de chaînes de caractèresPermet d'ajouter un entête à la requête de téléchargement. La syntaxe à utiliser est la suivante :
<Nom de la variable>.EntêteHTTP["Nom de l'entête"] =
"Valeur de l'entête"
ItinéranceAutoriséeBooléen
  • Vrai (par défaut) si le téléchargement peut utiliser l'itinérance des données.
  • Faux dans le cas contraire.
ModeNotificationConstante de type EntierMode de notification du téléchargement :
  • téléchargementNotifAucune : Aucune notification n'est visible.
    Remarque : l'utilisation de cette constante requiert l'ajout de la permission DOWNLOAD_WITHOUT_NOTIFICATION.
  • téléchargementNotifProgression (Valeur par défaut) : Tant que le téléchargement est en cours, une notification montre la progression et disparaît lorsque le téléchargement est terminé.
  • téléchargementNotifProgressionEtFin : Tant que le téléchargement est en cours, une notification montre la progression et reste visible lorsque le téléchargement est terminé.
ProcédureFinProcédure globale uniquementNom de la procédure à appeler à la fin du téléchargement que celui-ci soit terminé ou annulé :
  • Si l'application n'est pas lancée lors de la fin du téléchargement, le système lance l'application pour exécuter la procédure.
  • Si la procédure renvoie Vrai, le téléchargement sera supprimé du gestionnaire ainsi que le fichier téléchargé.
RéseauMobileAutoriséBooléen
  • Vrai (Valeur par défaut) si le téléchargement peut utiliser le réseau mobile.
  • Faux dans le cas contraire.
RéseauRestreintAutoriséBooléen
  • Vrai (valeur par défaut) si le téléchargement peut se faire sur un réseau restreint. Un réseau restreint signifie un réseau qui induit un coût monétaire à l'utilisateur, qui possède une limite de données ou ayant des problèmes de performance ou de batterie.
  • Faux dans le cas contraire.
SourceVariable de type URIAdresse http/https du fichier à télécharger.
TitreChaîne de caractèresTitre du téléchargement affiché dans la notification (si cette dernière est activée). Si cette propriété n'est pas spécifiée ou correspond à une chaîne vide (""), un titre par défaut basé sur le nom du fichier téléchargé sera automatiquement utilisé.
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