URIGetInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Mobile specific functions / URI functions

Selecting a resource
Management of the conversion type

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

URIGetInfo (Function)

In french: URIRécupèreInfo

Retrieves information of a URI resource.

Example

// Ouvre la fenêtre système pour la sélection d'une ressource
UriRessource is URI = URISelect()
IF NOT ErrorOccurred THEN
	// Affiche le nom de la ressource sélectionnée
	Info(URIGetInfo(UriRessource, uriInfoName))
END

// Sauvegarde d'une ressource avec conversion 
UriRessource is URI = URISelect()
IF NOT ErrorOccurred THEN
	// Récupère le type MIME dans lequel la ressource peut être convertie
	sTypeMIME is string = URIGetInfo(UriRessource, uriInfoConversionType)
	IF sTypeMIME <> "" THEN
		// S'il y a plusieurs types MIME possibles
		IF StringCount(sTypeMIME, CR) > 1 THEN
			// Demander à l'utilisateur de choisir le type à utiliser
			...
		END
		// Enregistre la ressource sur l'appareil
		URIToFile(UriRessource, SysDirExternalStorage(1, sseAppDocument), ...
					ProcFinEnregistre, sTypeMIME)
		INTERNAL PROCEDURE ProcFinEnregistre(bResultat, sCheminRessource)
			IF bResultat THEN
				ToastDisplay(StringBuild("Fichier enregistré (%1)", ...
						sCheminRessource))
			END
		END
	END
END

Syntax

<Result> = URIGetInfo(<URI> , <Information>)

<Result>: Character string or Integer

Requested information.
If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.

<URI>: URI or Character string variable

Name of the URI variable or character string that identifies the resource being handled.

<Information>: Integer constant

Requested type of information:
uriInfoConversionType MIME types (and corresponding file extensions) into which the resource can be converted when being exported. In this case, <Result> will correspond to a character string in the following format:
<MIME type> + TAB + <Extension>

Example: "application/pdf + TAB + pdf"
If the function returns several types, they will be separated by CR.
For more details, see the Remarks of this page.
uriInfoName Name of the resource (without extension).
uriInfoOriginType Original MIME type of the resource and corresponding file extension. In this case, <Result> will correspond to a character string in the following format:
<MIME type> + TAB + <Extension>

Example: "application/pdf + TAB + pdf"
uriInfoSize Size of the resource. <Result> will correspond to an integer:
Size of the resource (in bytes).
-1 if the size is not known or cannot be retrieved.

Remarks

Selecting a resource

To select a resource and get its URI, use URISelect.

Management of the conversion type

The constant uriInfoConversionType makes it possible to retrieve the MIME types in which the resource can be converted.

This information is especially useful when using URIToFile and URIToBuffer to determine the format in which the resource will be retrieved. Indeed, when selecting a resource that does not come from the device's file system, the content provider that manages the resource may need to convert it.

This is usually the case if no application on the device can manage the original format of the resource. If the resource can be exported without conversion, URIGetInfo will return the same value as with the constant uriInfoOriginType.

Example:
a Microsoft Word file (.doc or.docx) is selected using URISelect. This file is on Google Drive and no application on the device can handle this type of document. When saving this resource, the content provider will automatically convert this resource to PDF format. In this case, URIGetInfo used with the constant uriInfoConversionType will return the following string: "application/pdf + TAB + .pdf".

Component: wd300android.aar