|
|
|
|
|
- Conditions d'utilisation
- Avantage des filtres utilisateur
- Cas particuliers
TableActiveFiltre (Fonction) En anglais : TableEnableFilter 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. L'utilisateur peut supprimer le filtre : ![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) en définissant un nouveau filtre sur une colonne.
// 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 : | | filtreCommencePar | Affiche les lignes dont la valeur de la colonne spécifiée "Commence par" les caractères indiqués dans la <Valeur du filtre>. | filtreContient | Affiche les lignes dont la valeur de la colonne spécifiée "Contient" les caractères indiqués dans la <Valeur du filtre>. | filtreDifférent | Affiche les lignes dont la valeur de la colonne spécifiée "Est différente" des caractères indiqués dans la <Valeur du filtre>. | filtreEgal | Affiche les lignes dont la valeur de la colonne spécifiée "Est égale" aux caractères indiqués dans la <Valeur du filtre>. | filtreInférieur | Affiche 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érieurOuEgal | Affiche 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>. | filtreNeCommencePasPar | Affiche 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>. | filtreNeContientPas | Affiche les lignes dont la valeur de la colonne spécifiée "Ne contient pas" les caractères indiqués dans la <Valeur du filtre>. | filtreNeTerminePasPar | Affiche 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érieur | Affiche 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érieurOuEgal | Affiche 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>. | filtreTerminePar | Affiche 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 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). - 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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|