DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés HFSQL
  • Utilisation de la propriété FichierParcouru
  • Modification des propriétés liées au parcours d'un champ basé sur une table
  • Type de parcours
  • Manipulation des champs basés sur une table grâce aux propriétés
  • Limites
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é TableParcourue 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 une table:
  • les champs Table liée aux données ou Table hiérarchique liée aux données.
  • les champs Liste liée aux données ou Liste image liée aux données.
  • les champs Combo liée aux données.
  • les colonnes de table de type combo liée aux données.
  • les champs Zone répétée liée aux données.
  • WINDEV les champs Agenda lié aux données.
  • les champs Planning lié aux données.
  • WINDEV les champs Arbre lié aux données.
  • WINDEV les champs Organigramme fichier.
  • WINDEV les champs Tableau croisé dynamique.
  • les champs Kanban fichier.
  • les fenêtres internes (si le balayage est activé).
  • les superchamps.
Cette source de données peut être:
  • une table ou une requête. Les enregistrements affichés proviennent de cette table ou de cette requête.
  • une variable (tableau, membre de classe, membre d'un type avancé, etc.).
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 la table, la requête ou la variable utilisée 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 de la table 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 liée aux données, Table hiérarchique liée aux données.
  • Liste liée aux données, Liste image liée aux données.
  • Combo liée aux données.
  • Colonne de table de type combo liée aux données.
  • Zone répétée liée aux données.
  • WINDEV Agenda lié aux données.
  • Planning lié aux données.
  • WINDEV Arbre lié aux données.
  • WINDEV Organigramme fichier.
  • Fenêtre interne.
  • WINDEV Tableau croisé dynamique.
  • Kanban fichier.

Modifier la table, la requête ou la variable utilisée 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 liée aux données, Table hiérarchique liée aux données.
  • Liste liée aux données, Liste image liée aux données.
  • Combo liée aux données.
  • Colonne de table de type combo liée aux données.
  • Zone répétée liée aux données.
  • WINDEV Agenda lié aux données.
  • Planning lié aux données.
  • WINDEV Arbre lié aux données.
  • WINDEV Organigramme fichier.
  • Fenêtre interne.
  • WINDEV Tableau croisé dynamique.
  • 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 de la table 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 une table

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 tables de taille importante.

Type de parcours

  • Parcours automatique: WINDEV, WEBDEV et WINDEV Mobile prennent en charge le parcours de la table 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 de la table 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 une table grâce aux propriétés

  • Les enregistrements affichés dans les champs table proviennent de la table 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 liée aux données, Table hiérarchique liée aux données,
  • Champs Liste liée aux données, Liste image liée aux données,
  • Champs Combo liée aux données,
  • Superchamps,
  • Colonnes de table (permet de modifier la table liée à une colonne de table de type Combo).
  • Champs Zone répétée liée aux données,
  • WINDEV Champs Agenda lié aux données.
  • Champs Planning lié aux données.
  • WINDEV Champs Arbre lié aux données.
  • WINDEV Champs Organigramme fichier.
  • WINDEV Champs Tableau croisé dynamique.
  • les fenêtres internes (si le balayage est activé).
  • Champs Kanban fichier.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 05/12/2024

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