- 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
FichierParcouru (Propriété) En anglais : BrowsedFile
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,
Versions 16 et supérieures les champs Agenda fichier, Nouveauté 16 les champs Agenda fichier, les champs Agenda fichier, Versions 16 et supérieuresles champs Planning fichier, Nouveauté 16les champs Planning fichier, les champs Planning fichier, Versions 16 et supérieures les champs Arbre fichier, Nouveauté 16 les champs Arbre fichier, les champs Arbre fichier, Versions 17 et supérieures les champs Organigramme fichier. Nouveauté 17 les champs Organigramme fichier. les champs Organigramme fichier. Versions 19 et supérieuresles fenêtres internes (si le balayage est activé). Nouveauté 19les fenêtres internes (si le balayage est activé). 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"). Versions 15 et supérieures Nouveauté 15 Versions 17 et supérieures Nouveauté 17 Versions 18 et supérieures Nouveauté 18 Versions 20 et supérieures Nouveauté 20 Versions 21 et supérieures Nouveauté 21
// 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,
Versions 16 et supérieures Agenda fichier, Nouveauté 16 Agenda fichier, Agenda fichier, Versions 16 et supérieuresPlanning fichier, Nouveauté 16Planning fichier, Planning fichier, Versions 16 et supérieures Arbre fichier, Nouveauté 16 Arbre fichier, Arbre fichier, Versions 17 et supérieures Organigramme fichier. Nouveauté 17 Organigramme fichier. Organigramme fichier. Versions 19 et supérieuresFenêtre interne. Nouveauté 19Fenêtre interne. Fenêtre interne.
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,
Versions 16 et supérieures Agenda fichier, Nouveauté 16 Agenda fichier, Agenda fichier, Versions 16 et supérieuresPlanning fichier, Nouveauté 16Planning fichier, Planning fichier, Versions 16 et supérieures Arbre fichier, Nouveauté 16 Arbre fichier, Arbre fichier, Versions 17 et supérieures Organigramme fichier. Nouveauté 17 Organigramme fichier. Organigramme fichier. Versions 19 et supérieuresFenêtre interne. Nouveauté 19Fenêtre interne. Fenêtre interne.
<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 : - Stopper le parcours en affectant une chaîne vide ("") à la propriété FichierParcouru.
- Modifier les propriétés nécessaires.
- 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,
Versions 16 et supérieures Champs Agenda fichier, Nouveauté 16 Champs Agenda fichier, Champs Agenda fichier, Versions 16 et supérieuresChamps Planning fichier, Nouveauté 16Champs Planning fichier, Champs Planning fichier, Versions 16 et supérieures Champs Arbre fichier, Nouveauté 16 Champs Arbre fichier, Champs Arbre fichier, Versions 17 et supérieures Champs Organigramme fichier. Nouveauté 17 Champs Organigramme fichier. Champs Organigramme fichier. Versions 19 et supérieuresles fenêtres internes (si le balayage est activé). Nouveauté 19les fenêtres internes (si le balayage est activé). les fenêtres internes (si le balayage est activé).
Documentation également disponible pour…
|
|
|