DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Avantage des filtres utilisateur
  • Cas particuliers
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
Ajoute un filtre utilisateur sur une colonne d'un champ Table ou Table hiérarchique. Ce filtre pourra être désactivé par l'utilisateur ou grâce à la fonction TableDésactiveFiltre.
WINDEV Remarque : Lorsqu'un filtre utilisateur est défini sur un champ Table ou Table hiérarchique, l'icône suivante est affichée dans l'entête de la colonne :
Entonnoir
L'utilisateur peut supprimer le filtre :
  • WINDEV grâce à l'option "Supprimer le filtre" du menu contextuel de l'icône "entonnoir". Les filtres utilisateur font partie des FAA (Fonctionnalités Automatiques de vos Applications) disponibles sur les champs Table et Table hiérarchique. Pour plus de détails, consultez FAA sur les colonnes d'un champ Table.
Exemple
// Filtre la colonne Société pour afficher les sociétés commençant par "Fl"
TableActiveFiltre(TABLE_Client.COL_Societe, filtreCommencePar, "Fl")
Syntaxe
TableActiveFiltre(<Champ Table.Colonne> , <Type du filtre> , <Valeur du filtre>)
<Champ Table.Colonne> : Chaîne de caractères
Nom de la colonne où le filtre utilisateur doit être activé. Ce nom est de la forme :
<Champ Table>.<Champ Colonne>
<Champ Table> peut correspondre au nom d'un champ Table ou Table hiérarchique.
Exemple :
TABLE_TableClient.COL_NomSociété
<Type du filtre> : Constante de type Entier
Type de filtre à appliquer. Ce filtre peut être choisi parmi les valeurs suivantes :
filtreCommenceParAffiche les lignes dont la valeur de la colonne spécifiée "Commence par" les caractères indiqués dans la <Valeur du filtre>.
filtreContientAffiche les lignes dont la valeur de la colonne spécifiée "Contient" les caractères indiqués dans la <Valeur du filtre>.
filtreDifférentAffiche les lignes dont la valeur de la colonne spécifiée "Est différente" des caractères indiqués dans la <Valeur du filtre>.
filtreEgalAffiche les lignes dont la valeur de la colonne spécifiée "Est égale" aux caractères indiqués dans la <Valeur du filtre>.
filtreInférieurAffiche les lignes dont la valeur de la colonne spécifiée "Est inférieure" aux caractères indiqués dans la <Valeur du filtre>.
filtreInférieurOuEgalAffiche les lignes dont la valeur de la colonne spécifiée "Est inférieure ou égale" aux caractères indiqués dans la <Valeur du filtre>.
filtreNeCommencePasParAffiche les lignes dont la valeur de la colonne spécifiée "Ne commence pas par" les caractères indiqués dans la <Valeur du filtre>.
filtreNeContientPasAffiche les lignes dont la valeur de la colonne spécifiée "Ne contient pas" les caractères indiqués dans la <Valeur du filtre>.
filtreNeTerminePasParAffiche les lignes dont la valeur de la colonne spécifiée "Ne se termine pas par" les caractères indiqués dans la <Valeur du filtre>.
filtreSupérieurAffiche les lignes dont la valeur de la colonne spécifiée "Est supérieure" aux caractères indiqués dans la <Valeur du filtre>.
filtreSupérieurOuEgalAffiche les lignes dont la valeur de la colonne spécifiée "Est supérieure ou égale" aux caractères indiqués dans la <Valeur du filtre>.
filtreTermineParAffiche les lignes dont la valeur de la colonne spécifiée "Se termine par" les caractères indiqués dans la <Valeur du filtre>.
<Valeur du filtre> : Type correspondant à la colonne filtrée
Valeur à donner au filtre. Si ce paramètre correspond à une chaîne vide (""), le filtre est désactivé.
Remarques

Conditions d'utilisation

Cette fonction est disponible sur :
  • un champ Table ou Table hiérarchique fichier.
  • un champ Table ou Table hiérarchique par programmation.

Avantage des filtres utilisateur

Les filtres utilisateur sont modifiables par l'utilisateur final (à la différence d'un filtre mis en place par la fonction HFiltre ou par la propriété Filtre).

Cas particuliers

  • Si un filtre utilisateur est déjà activé sur la colonne spécifiée, la fonction TableActiveFiltre annule le filtre existant et le remplace par le nouveau filtre.
  • La propriété Filtre ne permet pas de connaître le filtre utilisateur utilisé.
  • La fonction TableColonnesFiltrées permet de connaître les filtres utilisateurs (définis directement par l'utilisateur ou par la fonction TableActiveFiltre).
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Filtre entre date ?
Comment filtrer sur une colonne date entre borne min et borne max ?

Par exemple les commandes créées entre le 07/12 et le 16/12 ?
Pascal
30 déc. 2023
Spécificité Table avec variable
ATTENTION : Si votre table se charge avec une variable (POO), il faut désactiver les filtres avant de recharger la table (TableAffiche).

Sinon les filtres sont permanents, même un TableDésactiveFiltre ne fonctionne plus.
Si on refiltre par dessus il additionne le nouveau filtre avec l'ancien sur la même colonne ...
Philippe
11 oct. 2021

Dernière modification : 25/05/2022

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