PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Generation wizard
  • Special case: Extracting a database
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Extracts a resource from the application into a physical device location.
Notes:
  • AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App The resource to extract must have been included in the generated application by the generation wizard (see Notes).
  • Versions 23 and later
    WindowsLinuxWindows Mobile In the WINDEV applications or in the WEBDEV sites, the resource to extract must be found in the main application library (WDL file).
    New in version 23
    WindowsLinuxWindows Mobile In the WINDEV applications or in the WEBDEV sites, the resource to extract must be found in the main application library (WDL file).
    WindowsLinuxWindows Mobile In the WINDEV applications or in the WEBDEV sites, the resource to extract must be found in the main application library (WDL file).
  • AndroidAndroid Widget This function can be used in the Android simulator.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 23 and later
WINDEVWindowsLinux This function is now available for the Windows and Linux applications.
WEBDEV - Server codeWindowsLinux This function is now available for the Windows and Linux sites.
Windows Mobile This function is now available for the Windows Mobile applications.
New in version 23
WINDEVWindowsLinux This function is now available for the Windows and Linux applications.
WEBDEV - Server codeWindowsLinux This function is now available for the Windows and Linux sites.
Windows Mobile This function is now available for the Windows Mobile applications.
WINDEVWindowsLinux This function is now available for the Windows and Linux applications.
WEBDEV - Server codeWindowsLinux This function is now available for the Windows and Linux sites.
Windows Mobile This function is now available for the Windows Mobile applications.
Example
Android
// Reads the content of readme.txt text file included in the application resources
IF fExtractResource("readme.txt", "/sdcard/extraction.txt") = True THEN
EDT_Text = fLoadText("/sdcard/extraction.txt"
END
Android
// Used to precisely locate the HFSQL data on the Android Smartphone
sDataPath is string = SysRepDirStorageCard() + fSep() + "Customer tests"  + fSep()
IF not fDirectoryExist(sDataPath) THEN fMakeDir(sDataPath)

fExtractResource("Product.fic", sDataPath + "Product.fic")
fExtractResource("Product.ndx", sDataPath + "Product.ndx")
fExtractResource("Product.mmo", sDataPath + "Product.mmo")

IF not HChangeDir(Product, sDataPath) THEN
Error(HErrorInfo())
END
Versions 19 and later
Android
// Extracts all the images in PNG format
fExtractResource("*.png", CompleteDir(SysDirStorageCard()) + "images")
New in version 19
Android
// Extracts all the images in PNG format
fExtractResource("*.png", CompleteDir(SysDirStorageCard()) + "images")
Android
// Extracts all the images in PNG format
fExtractResource("*.png", CompleteDir(SysDirStorageCard()) + "images")
Syntax
<Result> = fExtractResource(<Resource Name> [, <Destination>])
<Result>: Boolean
  • True if the resource was extracted,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo.
<Resource Name>: Character string (with quotes)
Name of resource to extract (file name with its extension).
Versions 19 and later
AndroidAndroid Widget iPhone/iPad The wildcard characters (* and?) are allowed. This allows you to extract several resources in a single call. In this case, the <Destination> parameter must correspond to a directory (that exists or not).
New in version 19
AndroidAndroid Widget iPhone/iPad The wildcard characters (* and?) are allowed. This allows you to extract several resources in a single call. In this case, the <Destination> parameter must correspond to a directory (that exists or not).
AndroidAndroid Widget iPhone/iPad The wildcard characters (* and?) are allowed. This allows you to extract several resources in a single call. In this case, the <Destination> parameter must correspond to a directory (that exists or not).
Versions 23 and later
WindowsLinuxWindows Mobile The resource to extract must be found in the main application library (WDL file). The library must have not been loaded by LoadWDL.
New in version 23
WindowsLinuxWindows Mobile The resource to extract must be found in the main application library (WDL file). The library must have not been loaded by LoadWDL.
WindowsLinuxWindows Mobile The resource to extract must be found in the main application library (WDL file). The library must have not been loaded by LoadWDL.
<Destination>: Optional character string (with quotes)
AndroidAndroid Widget Full or relative path of destination file. This path can be relative to the current directory (returned by fCurrentDir). This parameter is case sensitive.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the current application directory in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
Reminder: In Android, the file system is read-only on the device and on the emulator. An application has the rights to write into its setup directory or into one of its sub-directories, as well as onto the external memory (SDCard).
Universal Windows 10 App In Windows Phone, relative path of the destination file (in relation to the current directory). The current directory corresponds to the data directory of application.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
Reminder: In Windows Phone, only the files found in the data directory associated with the application can be handled.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the current application directory in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
iPhone/iPad Full path of destination file. This parameter is case sensitive.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the "Documents" application directory in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
Versions 23 and later
WindowsLinuxWindows Mobile Full path of destination file.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the application data directory (returned by fDataDir) in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
New in version 23
WindowsLinuxWindows Mobile Full path of destination file.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the application data directory (returned by fDataDir) in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
WindowsLinuxWindows Mobile Full path of destination file.
If the directory exists, the resource is directly extracted into this directory.
The directory is created if it does not exist.
If this parameter is not specified or if it corresponds to an empty string (""), the resource will be extracted into the application data directory (returned by fDataDir) in a file named like the resource.
The destination file will be overwritten if it already exists before the extraction.
Remarks
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App

Generation wizard

The wizard for generating Android, Universal Windows 10 app or iPhone/iPad applications allows you to specify whether files and libraries must be included in the application.
In an Android application, you have the ability to include:
  • specific resources.
  • specific Java archives.
Then, these files can be:
  • used directly (files to read for example: sound files, image files, ...).
  • extracted by fExtractResource (files to modify by the application for example).
If an image is included in the application, it can be directly assigned to a control by specifying its name. For example:
IMG_Image = image1
Versions 19 and later
AndroidAndroid Widget iPhone/iPad You have the ability to list the files included in the application with fListResource.
New in version 19
AndroidAndroid Widget iPhone/iPad You have the ability to list the files included in the application with fListResource.
AndroidAndroid Widget iPhone/iPad You have the ability to list the files included in the application with fListResource.
For more details, see:
AndroidAndroid Widget

Special case: Extracting a database

If the file to extract is a SQLite database, use fDataDir to extract it into the data directory of the application ("databases" directory).

Example:
fExtractResource(<Database vame>.db, CompleteDir(fDataDir()) + <Database name>.db)
To connect to this database, all you have to do is specify <Database name>.db as source for the SQLite connection. See Android application: Using a database for more details.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Windows Mobile wp230vm.dll
Linux wd230vm.so
Android wd230android.jar
Minimum required version
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment