AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones específicas para móviles / Funciones URI
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Guarda, en segundo plano, el contenido de un Resource (Image, texto, etc.) identificado por su URI en un archivo externo.
Ejemplo
AndroidWidget Android
// Open the system window to select a pdf
UriResource is URI = URISelect("application/pdf")
IF NOT ErrorOccurred THEN
// Save the resource in the application directory
URIToFile(UriResource, "document.pdf", ProcSave)
INTERNAL PROCÉDURE ProcSave (bResult, sPath)
IF bResult THEN
ToastDisplay("Saved successfully")
ELSE  
ToastDisplay("Unable to save")
END
END
END
AndroidWidget Android
// Save a resource with conversion
UriResource is URI = URISelect()
IF NOT ErrorOccurred THEN
// Retrieves the MIME type into which the resource can be converted
sMIMEType is string = URIGetInfo (UriResource, uriInfoConversionType)
IF sMIMEType <> "" THEN
// If there are several possible MIME types
IF StringCount(sMIMEType, TAB) > 1 THEN
// Ask the user to choose the type to use
...
END
// Save the resource on the device
URIToFile(UriResource, SysDirExternalStorage(1, sseAppDocument), ...
ProcEndSave, sMIMEType)
INTERNAL PROCEDURE ProcEndSave (bResult, sResourcePath)
IF bResult THEN
ToastDisplay(StringBuild("File saved (%1)", ...
sResourcePath))
END
END
END
END
Sintaxis
URIToFile(<URI> , <Path> , <Procedure> [, <MIME type>])
<URI>: URI o cadena de caracteres Variable
URI o variable de cadena de caracteres que identifica la resource a guardar.
<Path>: Cadena de caracteres
Corresponde a:
  • un directorio ruta (este directorio debe existir): la Resource se guardará en este directorio. El nombre del archivo creado corresponderá al nombre original del Resource, y su extensión dependerá del formato utilizado para guardarlo (ver notas).
  • Un archivo completo o relativo ruta. Si el archivo ya existe, se sobrescribirá.
    Atención: la extensión del archivo no se modificará aunque el Resource tuviera que ser convertido a otro formato para ser guardado.
El ruta completo del archivo guardado se pasará como un parámetro del Procedure llamado una vez que se haya completado el guardado.
<Procedure>: Nombre de la lengua Procedure
Nombre de la WLanguage Procedure ("callback") llamada una vez que se ha completado el guardado. Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name> (<Result>, <Path>)
donde:
  • <El resultado es booleano:
    • True si se guardó correctamente,
    • False en caso contrario. Para get más detalles sobre el error, utilice ErrorInfo antes de cualquier otra llamada a una función de WLanguage (esto reiniciaría el error).
  • <Path> es una cadena de caracteres que corresponde al archivo completo ruta utilizado para guardar.
<MIME type>: Cadena de caracteres opcional
Tipo de MIME correspondiente al formato en el que debe guardarse el Resource (ver Notas).
Si este parámetro no se especifica o corresponde a una cadena vacía (""), el Resource se guardará en su formato original si es posible o se convertirá primero a un formato Default.
Observaciones
  • Para seleccionar una Resource y get su URI, utilice URISelect.
  • Cuando el Resource a guardar no proviene del sistema de archivos del dispositivo, el proveedor de contenido que administra el Resource puede necesitar convertir este Resource. Esto suele ocurrir si ninguna aplicación del dispositivo puede manejar el formato original de la Resource. Es posible especificar el formato de conversión de la Resource introduciendo el parámetro <Tipo MIME>. Para conocer el tipo MIME en el que se puede convertir un recurso, utilice la función URIGetInfo con la constante uriInfoConversionType. Si esta función devuelve una cadena vacía (""), la Resource no puede ser guardada. En este caso, no llame a URIToFile en este Resource, ya que fallará.
    Ejemplo:
    se selecciona un archivo de Microsoft Word (.doc o.docx) mediante URISelect. Este archivo está en el disco de Google y ninguna aplicación en el dispositivo puede manipular este tipo de Document. Al guardar este Resource, el proveedor de contenido convertirá automáticamente este Resource al formato PDF. En este caso, URIGetInfo utilizado con la constante uriInfoConversionType devolverá la siguiente cadena "application/pdf + TAB + .pdf".
Componente: wd290android.aar
Versión mínima requerida
  • Versión 24
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local