PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Why include the data files in a library?
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
HChangeLocation (Function)
In French: HChangeLocalisation
HFSQLHFSQL Client/ServerAvailable only with these kinds of connection
Modifies the search mode of physical data files (.FIC, .NDX, ...). By default, the physical data files are sought in the application library then on disk.
Reminder: The physical data files can be found:
  • on disk (most common case).
  • in the WINDEV libraries (WDL files).
  • in the executable.
  • in a component.
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.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 22 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 22
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.
Example
// Find files in libraries 4, 6 and 9
HChangeLocation(CustomerFile, hWDL, 4, 6, 9)
Syntax
<Result> = HChangeLocation(<File Name> , <Search Mode> [, <Parameters>])
<Result>: Boolean
  • True if the operation was performed,
  • False if a problem occurred. HError is used to identify the error.
HFSQL Client/Server If HChangeLocation is used, <Result> = True but the function has no effect: the data files used are always found on the server.
<File Name>: Character string (with or without quotes)
Logical name of the data file (defined in the analysis).
If this parameter is equal to "*", the change of search mode will be applied to all the known data files (described in the analysis).
Caution: the affected data files are automatically closed.
This parameter can also correspond to the name of a group of files (or custom-folder) defined in the analysis.
<Search Mode>: Constant
Configures the search mode of data files:
hDiskThe data files are sought on disk only. This is the most common case.
hWDL
(Default value)
The data files are sought:
  1. In the main WDL;
  2. If <Parameter> is not specified: Searches for the data files in the WDLs according to the load order, then on disk.
    If <Parameter> is specified: Searches for the data files in the specified WDLs, then on disk.
  3. In the main WDL of the component.
  4. In the secondary WDLs of the component according to the load order.
<Parameters>: Optional character string (with quotes)
Identifier of the WDLs where the search must be performed. These WDLs must be loaded by LoadWDL that returns the identifier of the WDL.
Remarks

Why include the data files in a library?

Including the data files in a library presents the following benefits:
  • protecting data: the data files are accessible in read-only.
  • grouping data: all the files required by the execution are grouped in a single file.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Linux wd230hf.so
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment