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
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurPHP 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.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP grâce à l'option "Supprimer le filtre" du menu ouvert en cliquant sur l'icône "entonnoir". Les filtres utilisateur font partie des fonctionnalités disponibles sur les champs Table (Navigateur ou Ajax) et sur les champs Table hiérarchique.
  • AndroidiPhone/iPad en définissant un nouveau filtre sur une colonne.
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.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode Ajax, les champs Table en mode classique et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Le champ Table hiérarchique n'est pas disponible.

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 : 16/09/2024

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