DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés HFSQL
  • Propriété Filtre et champs Table liée aux données
  • Manipulation des champs Table, Liste, Liste image, Combo et Zone répétée liée aux données 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 liée aux données
  • Limite
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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 liée aux données,
  • les champs Table hiérarchique fichier,
  • les champs Liste liée aux données,
  • les champs Combo liée aux données,
  • les champs Zone répétée liée aux données.
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 la table sur laquelle est basé l'objet (sauf pour les champs table liée aux données, 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).
Exemple
// -- Code à chaque modification d'un champ Combo
// Mise à jour des éléments du champ Combo en fonction
// des lettres saisies dans le champ de saisie du 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:
  • Liste ou Liste image fichier,
  • Combo liée aux données,
  • Table ou Table hiérarchique fichier,
  • Zone répétée liée aux données.

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:
  • Liste ou Liste image fichier,
  • Combo liée aux données,
  • Table ou Table hiérarchique fichier,
  • Zone répétée liée aux données.
<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 champs Table liée aux données

Pour les champs Table liée aux données, 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 "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 à la table sur laquelle est basé le champ. Un parcours effectué ensuite sur le fichier de base du champ sera donc filtré.
  • Un filtre (fonction HFiltre) est automatiquement appliqué à la table sur laquelle est basé le champ Table.
  • Si un filtre est défini sur la table (fonction HFiltre) AVANT d'afficher le champ Table (fonction TableAffiche par exemple), seul le filtre du champ Table sera pris en compte. Le parcours de la table sera ensuite réalisé selon le filtre du champ Table.

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

  • Les enregistrements affichés dans un champ Liste, Table, Combo ou Zone répétée liée aux données proviennent de la table ou de la requête spécifiée avec la propriété TableParcourue.
  • 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 liée aux données

Pour modifier plusieurs des propriétés RubriqueParcourue, Filtre et TableParcourue, il est conseillé de:
  1. Stopper le parcours en affectant une chaîne vide ("") à la propriété TableParcourue.
  2. Modifier les propriétés nécessaires.
  3. Relancer le parcours avec la propriété TableParcourue.
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 liée aux données,
  • Champ Liste image fichier,
  • Champ Combo liée aux données,
  • Champ table liée aux données,
  • Champ Zone répétée liée aux données,
  • Champ Table hiérarchique fichier.
Composante: wd300.dll
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/12/2024

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