DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Utilisation de la propriété FichierParcouru
  • Modification des propriétés liées au parcours d'un champ basé sur un fichier de données
  • Type de parcours
  • Manipulation des champs basés sur un fichier de données grâce aux propriétés
  • Limites
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
La propriété FichierParcouru permet de connaître et de modifier la source de données utilisée pour l'affichage des enregistrements dans les champs basés sur un fichier de données :
  • les champs Table fichier ou Table hiérarchique fichier.
  • les champs Liste fichier ou Liste image fichier.
  • les champs Combo fichier.
  • les colonnes de table de type combo fichier.
  • les champs Zone répétée fichier.
  • les champs Planning fichier.
  • Nouveauté 28
    les champs Kanban fichier.
  • les fenêtres internes (si le balayage est activé).
  • les superchamps.
Cette source de données peut être :
  • un fichier de données ou une requête. Les enregistrements affichés proviennent de ce fichier de données ou de cette requête.
  • une variable (tableau, membre de classe, membre d'un type avancé, ...)
Cette source de données est définie lors de la description du champ (onglet "Contenu").
Exemple
// Affiche tous les clients dans un champ Table
TABLE_Table1.FichierParcouru = "Clients"
// Affiche tout le contenu de la requête Req_Clients dans un champ Table
TABLE_Table1.FichierParcouru = "Req_Clients"
 
// Affiche les contacts de la variable gUnContact
// gUnContact est une variable de type gglContact
TABLE_Table1.FichierParcouru = ":gUnContact"
Syntaxe

Connaître le fichier de données, la requête ou la variable utilisé comme source de données Masquer les détails

<Elément parcouru> = <Champ manipulé>.FichierParcouru
<Elément parcouru> : Chaîne de caractères
Nom de l'élément utilisé comme source de données du champ considéré. Cet élément peut correspondre :
  • au nom du fichier de données ou de la requête.
  • au nom de la variable. Ce nom est de la forme ":<préfixe><Nom de la variable>" ou bien ":<Nom de la variable>". Le préfixe est présent uniquement si la charte de programmation est activée dans le projet.
<Champ manipulé> : Nom de champ
Nom du champ dont on veut connaître la source de données. Ce champ doit être un champ de type :
  • Table fichier, Table hiérarchique fichier.
  • Liste fichier, Liste image fichier.
  • Combo fichier.
  • Colonne de table de type combo fichier.
  • Zone répétée fichier.
  • Planning fichier.
  • Fenêtre interne.
  • Nouveauté 28
    Kanban fichier.

Modifier le fichier de données, la requête ou la variable utilisé comme source de données Masquer les détails

<Champ manipulé>.FichierParcouru = <Nouvelle source de données>
<Champ manipulé> : Nom de champ
Nom du champ dont on veut modifier la source de données en cours. Ce champ doit être un champ de type :
  • Table fichier, Table hiérarchique fichier.
  • Liste fichier, Liste image fichier.
  • Combo fichier.
  • Colonne de table de type combo fichier.
  • Zone répétée fichier.
  • Planning fichier.
  • Fenêtre interne.
  • Nouveauté 28
    Kanban fichier.
<Nouvelle source de données> : Chaîne de caractères
Nom de l'élément qui doit être associé au champ considéré :
  • Nom du fichier de données ou de la requête.
  • Nom de la variable. Ce nom est de la forme ":<préfixe><Nom de la variable>" ou bien ":<Nom de la variable>". Le préfixe doit être précisé si la charte de programmation est activée dans le projet (que les préfixes soient affichés ou non).
Si ce paramètre ne correspond pas à un nom valide, le champ sera vide. Si ce paramètre correspond à une chaîne vide, le parcours sera arrêté.
Remarques

Utilisation de la propriété FichierParcouru

La propriété FichierParcouru peut être utilisée aussi bien lors d'un parcours programmé que lors d'un parcours automatique.
Si la propriété FichierParcouru est utilisée pour modifier la source de données utilisée, le parcours est ré-initialisé. Dans le cas d'un champ Table, ce fonctionnement est identique à l'utilisation de la fonction TableAffiche avec la constante taDébut.

Modification des propriétés liées au parcours d'un champ basé sur un fichier de données

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 données de taille importante.

Type de parcours

  • Parcours automatique : WINDEV, WEBDEV et WINDEV Mobile prennent en charge le parcours du fichier de données et l'affichage des données dans le champ. Le développeur n'a aucun code spécifique à saisir.
    Si le champ peut être trié (table, ...), le tri est effectué sur la rubrique de parcours définie dans l'onglet "Contenu" de la description de l'élément.
    Si un filtre est spécifié (option "Filtre sur la rubrique de parcours" dans l'onglet "Contenu" de la description de l'objet), ce filtre est utilisé.
  • Parcours programmé : Le développeur doit programmer le parcours du fichier de données et l'affichage des données dans le champ.
    Un parcours programmé permet un contrôle total sur l'ordre et le filtrage des enregistrements. Cependant, un parcours programmé est plus complexe et plus lent qu'un parcours automatique.

Manipulation des champs basés sur un fichier de données grâce aux propriétés

  • Les enregistrements affichés dans les champs fichier proviennent du fichier de données ou de la requête spécifiés avec la propriété FichierParcouru.
  • Le sens de tri est fixé par la propriété RubriqueParcourue.
  • Selon le type de champ, un filtrage des enregistrements peut être réalisé grâce à la propriété Filtre ou à la fonction HFiltre.

Limites

La propriété FichierParcouru s'applique uniquement aux champs d'une fenêtre ou d'une page. Cette propriété s'applique uniquement aux champs suivants :
  • Champs Table fichier, Table hiérarchique fichier,
  • Champs Liste fichier, Liste image fichier,
  • Champs Combo fichier,
  • Superchamps,
  • Colonnes de table (permet de modifier le fichier de données lié à une colonne de table de type Combo).
  • Champs Zone répétée fichier,
  • Champs Planning fichier.
  • les fenêtres internes (si le balayage est activé).
  • Nouveauté 28
    Champs Kanban fichier.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire