ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / HFSQL functions
  • 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/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Enables the filter that was previously created for the specified data file (view or query). This filter was created by <Source>.Filter and disabled by <Source>.DeactivateFilter. <Source>.ActivateFilter has no effect if no filter was declared.
This function can be used with the data files, HFSQL views or queries.
Example
// Declare the filter: select customers
// between 20 and 60 years old
Customer.Filter(Age_Customer, 20, 60)
...
Customer.DeactivateFilter() // Disabled filter
...
// Browse the data file with a filter on age
// Process the customers who are between 20 and 60 years old
// (ProcessCustomer2060 procedure)
Customer.ActivateFilter()
Customer.ReadFirst(Age_Customer)
WHILE Customer.Found() = True
ProcessCustomer2060()
Customer.ReadNext(Age_Customer)
END
Syntax
<Result> = <Source>.ActivateFilter()
<Result>: Boolean
  • True if the filter is enabled,
  • False if an error occurred (file or item not found).
<Source>: Type corresponding to the specified source
Name of data file, HFSQL view or query used.
Remarks

Enabling and disabling a filter

The filter is enabled once it has been declared (<Source>.Filter). The filter can be disabled by <Source>.DeactivateFilter.

Number of possible active filters

A single filter can be enabled at a time for a specific data file.
Reports and QueriesWindowsOLE DB

Operating mode in OLE DB

If <Source>.ActivateFilter is used when navigating through a data file, the navigation is stopped. To take the filter into account, you must navigate through the data file again with <Source>.ReadFirst/<Source>.First or <Source>.ReadLast/<Source>.Last.
The current position and all the stored positions are lost. The position will be restored according to the value of best item.
Component: wd290hf.dll
Minimum version required
  • Version 25
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/06/2023

Send a report | Local help