PC SOFT

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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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,
  • Versions 16 et supérieures
    WINDEV les champs Agenda fichier,
    Nouveauté 16
    WINDEV les champs Agenda fichier,
    WINDEV les champs Agenda fichier,
  • Versions 16 et supérieures
    les champs Planning fichier,
    Nouveauté 16
    les champs Planning fichier,
    les champs Planning fichier,
  • Versions 16 et supérieures
    WINDEV les champs Arbre fichier,
    Nouveauté 16
    WINDEV les champs Arbre fichier,
    WINDEV les champs Arbre fichier,
  • Versions 17 et supérieures
    WINDEV les champs Organigramme fichier.
    Nouveauté 17
    WINDEV les champs Organigramme fichier.
    WINDEV les champs Organigramme fichier.
  • Versions 19 et supérieures
    les fenêtres internes (si le balayage est activé).
    Nouveauté 19
    les 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
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 17 et supérieures
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
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.
Versions 21 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
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> = <Nom du champ>..FichierParcouru
<Elément parcouru> : Chaîne de caractères (entre guillemets)
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.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
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
    WINDEV agenda fichier,
    Nouveauté 16
    WINDEV agenda fichier,
    WINDEV agenda fichier,
  • Versions 16 et supérieures
    planning fichier,
    Nouveauté 16
    planning fichier,
    planning fichier,
  • Versions 16 et supérieures
    WINDEV arbre fichier,
    Nouveauté 16
    WINDEV arbre fichier,
    WINDEV arbre fichier,
  • Versions 17 et supérieures
    WINDEV organigramme fichier.
    Nouveauté 17
    WINDEV organigramme fichier.
    WINDEV organigramme fichier.
  • Versions 19 et supérieures
    fenêtre interne.
    Nouveauté 19
    fenêtre interne.
    fenêtre interne.

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

<Nom du champ>..FichierParcouru = <Nouvelle source de données>
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
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
    WINDEV agenda fichier,
    Nouveauté 16
    WINDEV agenda fichier,
    WINDEV agenda fichier,
  • Versions 16 et supérieures
    planning fichier,
    Nouveauté 16
    planning fichier,
    planning fichier,
  • Versions 16 et supérieures
    WINDEV arbre fichier,
    Nouveauté 16
    WINDEV arbre fichier,
    WINDEV arbre fichier,
  • Versions 17 et supérieures
    WINDEV organigramme fichier.
    Nouveauté 17
    WINDEV organigramme fichier.
    WINDEV organigramme fichier.
  • Versions 19 et supérieures
    fenêtre interne.
    Nouveauté 19
    fenê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 :
  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,
  • Versions 16 et supérieures
    WINDEV Champs Agenda fichier,
    Nouveauté 16
    WINDEV Champs Agenda fichier,
    WINDEV Champs Agenda fichier,
  • Versions 16 et supérieures
    Champs Planning fichier,
    Nouveauté 16
    Champs Planning fichier,
    Champs Planning fichier,
  • Versions 16 et supérieures
    WINDEV Champs Arbre fichier,
    Nouveauté 16
    WINDEV Champs Arbre fichier,
    WINDEV Champs Arbre fichier,
  • Versions 17 et supérieures
    WINDEV Champs Organigramme fichier.
    Nouveauté 17
    WINDEV Champs Organigramme fichier.
    WINDEV Champs Organigramme fichier.
  • Versions 19 et supérieures
    les fenêtres internes (si le balayage est activé).
    Nouveauté 19
    les fenêtres internes (si le balayage est activé).
    les fenêtres internes (si le balayage est activé).
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire