PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Enabling and disabling a filter
  • Number of possible active filters
  • Operating mode in OLE DB
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
Enables the filter that was previously created for the specified data file (view or query). This filter was created by HFilter and disabled by HDeactivateFilter. HActivateFilter has no effect if no filter was declared.
This function can be used with the data files, HFSQL views or queries.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
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.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Example
// Declare the filter: selecting the customers
// who are between 20 and 60 years old
HFilter(CUSTOMER, AGE_Customer, 20, 60)
...
HDeactivateFilter(CUSTOMER) // Disabled filter
...
// Browse the file with a filter on the age
// Process the customers who are between 20 and 60 years old
// (ProcessCustomer2060 procedure)
HActivateFilter(CUSTOMER)
HReadFirst(CUSTOMER, AGE_Customer)
WHILE HFound(CUSTOMER) = True
ProcessCustomer2060()
HReadNext(CUSTOMER, AGE_Customer)
END
Syntax
<Result> = HActivateFilter([<File Name>])
<Result>: Boolean
  • True if the filter is enabled,
  • False if an error occurred (file or item not found).
<File Name>: Optional character string (with or without quotes)
Name of data file, HFSQL view or query used.
Remarks

Enabling and disabling a filter

The filter is enabled once it has been declared (HFilter). The filter can be disabled by HDeactivateFilter.

Number of possible active filters

A single filter can be enabled at a time for a specific data file.
WINDEVWEBDEV - Server codeReports and QueriesWindowsAjaxUser code (UMC)External languageOLE DB

Operating mode in OLE DB

If HActivateFilter is used when browsing a data file, the browse is stopped. To take the filter into account, the browse must be reinitialized with HReadFirst/HFirst or HReadLast/HLast.
The current position and all the stored positions are lost. The position will be restored according to the value of best item.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Java wd230java.jar
Linux wd230hf.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment