|
|
|
|
- Propiedades específicas de las variables DownloadParameter
DownloadParameter (Tipo de Variable)
El tipo DownloadParameter se utiliza para definir todas las características avanzadas de una descarga de archivo realizada por DownloadAdd 00300030002f002300. Las características de esta descarga pueden definirse y modificarse mediante diferentes propiedades de WLanguage. Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable. // Procedure to call at the end of the download PROCEDURE DownloadCompleted(InfoDownload is DownloadInfo) IF InfoDownload.Status = downloadStatusSuccessful THEN Info(InfoDownload.Title + " has been downloaded successfully." RESULT False END // --------------- // Create a DownloadParameter variable // to store the download information ParameterDownload is DownloadParameter // Specify the parameters of the download ParameterDownload.Source = ... "https://windev.com/storage/en_US/img/visual/25/logo-pcsoft.png" ParameterDownload.Title = "PC Soft Logo" ParameterDownload.Description = "PC Soft company logo" ParameterDownload.Destination = SysDirExternalStorage(1, sseAppDownload) ParameterDownload.MobileNetworkAllowed = True ParameterDownload.MeteredNetworkAllowed = False ParameterDownload.RequiresCharging = True ParameterDownload.NotificationMode = downloadNotifProgressAndCompletion // Procedure to call at the end of the download ParameterDownload.ProcedureEnd = "DownloadCompleted" // The download is added to the list of downloads to be started // (The download manager will start the download as soon as possible). nID is int = DownloadAdd(ParameterDownload) telInfo is DownloadInfo = DownloadGetInfo(nID) Info(telInfo.Title)
Observaciones Propiedades específicas de las variables DownloadParameter Las siguientes propiedades pueden utilizarse para manipular las características de una descarga: | | | Nombre de la propiedad | Tipo utilizado | Efecto |
---|
Cabecera | Array de cadenas de caracteres | Se utiliza para añadir una cabecera a la solicitud de descarga. Se debe utilizar la siguiente sintaxis:
<Variable name>.HTTPHeader["Header name"] = "Value of header" | description | Cadena de caracteres | Descripción de la descarga que aparece en la Notification (si está activada). Observación: Esta propiedad es opcional. | Destino | Cadena de caracteres | Address física donde se almacenará el archivo. La ruta debe corresponder a: - el almacenamiento externo del dispositivo,
- las carpetas de la aplicación,
- la carpeta de descargas públicas, accesible llamando a SysDirExternalStorage con el ssePublicDownload constante.
Si no se especifica ningún destino o si esta Property es una cadena vacía, el archivo se descargará en la carpeta de descargas de public.Observación: Esta propiedad es opcional. | Fuente | Variable de tipo URI | http/https Address del archivo a descargar. | MeteredNetworkAllowed | booleano | - True ( Default ) si la descarga se puede realizar a través de una red medida. Una red con contador es una red que tiene un coste para el usuario, tiene un límite de datos o tiene problemas de rendimiento o de batería.
- False en caso contrario.
| MobileNetworkAllowed | booleano | - True (valor Default ) si la red móvil se puede usar para la descarga.
- False en caso contrario.
| NotificationMode | Constante de tipo Integer | Descargar el modo Notification: - downloadNotifNone: No se muestran notificaciones.
Observación: esta constante requiere que se añada la etiqueta DOWNLOAD_WITHOUT_Notification Permission. - downloadNotifProgress (valor Default ): Una Notification muestra el progreso de la descarga y desaparece cuando ésta se completa.
- downloadNotifProgressAndCompletion: Un Notification muestra el progreso de la descarga y se queda Visible cuando la descarga está completa.
| ProcedureEnd | Global Procedure solamente | Nombre de la Procedure que se llamará al final de la descarga, tanto si se ha completado como si se ha cancelado: - Si la aplicación no se inicia la descarga se completa, el sistema inicia la aplicación para ejecutar el Procedure.
- Si Procedure devuelve True , la descarga se eliminará y el archivo descargado se eliminará.
| RequiresCharging | booleano | - True si la descarga requiere que el teléfono sea Charging ,
- False (valor predeterminado) en caso contrario.
| RoamingAllowed | booleano | - True ( Default ) si se puede usar el roaming de datos para la descarga.
- False en caso contrario.
| Título | Cadena de caracteres | Título de la descarga que aparece en la Notification (si está activada). Si no se especifica esta Property o es una cadena vacía (""), se utilizará automáticamente un título Default basado en el nombre del archivo descargado. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|