PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Propriété Filtre et champ Table fichier
  • Manipulation des champs Table, Liste, Liste image, Combo et Zone répétée fichier grâce aux propriétés
  • Modification des propriétés liées au parcours d'un champ Table, Liste, Liste image, Combo ou Zone répétée fichier
  • Limite
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
La propriété ..Filtre permet de connaître et de modifier le filtre utilisé pour l'affichage des enregistrements dans :
  • les champs Table fichier,
  • les champs Table hiérarchique fichier,
  • les champs Liste fichier,
  • les champs Combo fichier,
  • les champs Zone répétée fichier.
Ce filtre (s'il existe) peut être défini lors de la description du champ (onglet "Contenu").
Ce filtre (propriété ..Filtre ou filtre saisi sous l'éditeur) a les caractéristiques suivantes :
  • filtre du type "Commence par".
  • s'applique uniquement à la rubrique de parcours.
  • a une influence sur l'objet manipulé (champ Table, Combo, Liste ou Liste image).
  • n'a pas d'influence sur le fichier de données sur lequel est basé l'objet (sauf pour les champs Table fichier, voir ci-dessous).
Remarques :
  • Pour utiliser un filtre sur une clé composée, il est conseillé d'utiliser la fonction HFiltre.
  • La propriété ..Filtre ne permet pas de connaître les filtres utilisateur définis (par exemple avec la fonction TableActiveFiltre).
Versions 15 et supérieures
Android Cette propriété est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette propriété est désormais disponible pour les applications Android.
Android Cette propriété est désormais disponible pour les applications Android.
Versions 20 et supérieures
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table et les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
Nouveauté 20
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table et les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table et les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
Exemple
// -- Code à chaque modification d'un champ Combo
// Mise à jour des éléments du champ en fonction
// des lettres saisies dans le champ Combo
COMBO_Elément..Filtre = COMBO_Elément
// Identifie la condition de filtre sur la clé de parcours Ville
SI TABLE_Client..Filtre = "" ALORS
        TABLE_Client..Filtre = "PARIS"
FIN
Syntaxe

Connaître le filtre défini sur la rubrique de parcours Masquer les détails

<Valeur du filtre> = <Champ manipulé>..Filtre
<Valeur du filtre> : Type du filtre
Valeur actuelle du filtre défini sur la rubrique de parcours. Ce filtre est du type "Commence par".
<Champ manipulé> : Nom de champ
Nom du champ dont on veut connaître le filtre en cours : ce filtre a été défini soit par la propriété ..Filtre, soit directement sous l'éditeur de fenêtres ou de pages (dans la description du champ). Ce champ doit être un champ de type :
  • Champ Liste ou Liste image fichier,
  • Champ Combo fichier,
  • Champ Table ou Table hiérarchique fichier,
  • Champ Zone répétée fichier.

Modifier le filtre défini sur la rubrique de parcours Masquer les détails

<Champ manipulé>..Filtre = <Nouvelle valeur du filtre>
<Champ manipulé> : Nom de champ
Nom du champ dont on veut modifier le filtre en cours. Ce champ doit être un champ de type :
  • Champ Liste ou Liste image fichier,
  • Champ Combo fichier,
  • Champ Table ou Table hiérarchique fichier,
  • Champ Zone répétée fichier.
<Nouvelle valeur du filtre> : Type du filtre
  • Nouvelle valeur du filtre défini sur la clé de parcours,
  • Chaîne vide ("") pour aucun filtre.
Remarques

Propriété Filtre et champ Table fichier

Pour les champs Table fichier, la case à cocher "Filtrer également le fichier (HFiltre)" permet de conserver les options de recherche et de tri sur les colonnes filtrées (loupe, ...).Pour les champs Table fichier, la case à cocher "Utiliser la fonction HFiltre pour parcourir le fichier" permet de conserver les options de recherche et de tri sur les colonnes filtrées (loupe, ...).
Si l'option "Filtrer également le fichier (HFiltre)" est cochée :Si l'option "Utiliser la fonction HFiltre pour parcourir le fichier" est cochée :
  • la propriété n'est plus appliquée uniquement au champ Table mais également au fichier de données sur lequel est basé le champ. Le prochain parcours effectué sur le fichier de données associé au champ sera donc filtré.
  • Un filtre (fonction HFiltre) est automatiquement appliqué au fichier de données sur lequel est basé le champ Table.
  • Si un filtre est défini sur le fichier de données (fonction HFiltre) AVANT d'afficher le champ Table (fonction TableAffiche par exemple), seul le filtre du champ Table sera pris en compte. Le parcours du fichier de données sera ensuite réalisé selon le filtre du champ Table.

Manipulation des champs Table, Liste, Liste image, Combo et Zone répétée fichier grâce aux propriétés

  • Les enregistrements affichés dans un champ Liste, Table, Combo ou Zone répétée fichier proviennent du fichier de données ou de la requête spécifié avec la propriété ..FichierParcouru.
  • Le sens de tri est fixé par la propriété ..RubriqueParcourue.
  • Un filtrage des enregistrements peut être réalisé grâce à la propriété ..Filtre ou à la fonction HFiltre. Attention : la propriété ..Filtre permet uniquement un filtrage du type "Commence par" sur la clé de parcours.

Modification des propriétés liées au parcours d'un champ Table, Liste, Liste image, Combo ou Zone répétée fichier

Pour modifier plusieurs des propriétés ..RubriqueParcourue, ..Filtre et ..FichierParcouru, il est conseillé de :
  1. Stopper le parcours en affectant une chaîne vide ("") à la propriété ..FichierParcouru.
  2. Modifier les propriétés nécessaires.
  3. Relancer le parcours avec la propriété ..FichierParcouru.
Cette méthode permet d'optimiser les modifications réalisées. En effet, chacune des modifications effectuée individuellement relance le parcours. Ces opérations peuvent vite devenir lentes sur des fichiers de taille importante.

Limite

La propriété ..Filtre s'applique uniquement aux champs d'une fenêtre ou d'une page. Cette propriété s'applique uniquement aux champs suivants :
  • Champ Liste fichier,
  • Champ Liste image fichier,
  • Champ Combo fichier,
  • Champ Table fichier,
  • Champ Zone répétée fichier,
  • Champ Table hiérarchique fichier.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire