DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Activation et désactivation d'un filtre
  • Nombre de filtres actifs possibles
  • Fonctionnement en OLE DB
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Active le filtre précédemment créé pour le fichier de données (la vue ou la requête) spécifié. Ce filtre a été créé avec la fonction HFiltre et désactivé avec la fonction HDésactiveFiltre. Si aucun filtre n'a été déclaré, la fonction HActiveFiltre est sans effet.
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL ou les requêtes.
Exemple
// Déclaration du filtre : sélection des clients
// qui ont entre 20 et 60 ans
HFiltre(Client, Age_Client, 20, 60)
...
HDésactiveFiltre(Client) // Filtre désactivé
...
// Parcours du fichier de données avec filtre sur l'âge
// Traitement des clients qui ont entre 20 et 60 ans
// (procédure TraiteClient2060)
HActiveFiltre(Client)
HLitPremier(Client, Age_Client)
TANTQUE HTrouve(Client) = Vrai
	TraiteClient2060()
	HLitSuivant(Client, Age_Client)
FIN
Syntaxe
<Résultat> = HActiveFiltre([<Fichier de données>])
<Résultat> : Booléen
  • Vrai si le filtre est activé,
  • Faux en cas d'erreur (fichier ou rubrique inexistant).
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données, de la vue HFSQL ou de la requête manipulé.
Remarques

Activation et désactivation d'un filtre

Après la déclaration d'un filtre (fonction HFiltre), le filtre est actif. Le filtre peut être désactivé grâce à la fonction HDésactiveFiltre.

Nombre de filtres actifs possibles

Pour un fichier de données spécifique, un seul filtre peut être actif à la fois.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsOLE DB

Fonctionnement en OLE DB

Si la fonction HActiveFiltre est utilisée lors du parcours d'un fichier de données, le parcours est arrêté. Pour prendre en compte le filtre, il faut ré-initialiser le parcours avec les fonctions HLitPremier/HPremier ou HLitDernier/HDernier.
La position en cours et toutes les positions sauvegardées sont perdues. La restauration de la position sera effectuée à partir de la valeur de la meilleure rubrique.
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale