DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs
  • Type de parcours
  • Manipuler des champs liés à un fichier de données grâce aux propriétés
  • Modifier les propriétés liées au parcours d'un champ fichier
  • Table par programmation
  • Champ Liste et champ Combo par programmation
  • 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
Pour les champs, la propriété RubriqueParcourue permet de :
  • Connaître la rubrique utilisée pour le parcours automatique des champs liés à un fichier de données.
  • Modifier la rubrique utilisée pour le parcours automatique des champs liés à un fichier de données. Le parcours est alors réinitialisé.
Pour un état sur fichier, la propriété RubriqueParcourue permet de modifier la rubrique utilisée pour le parcours du fichier de données. Dans ce cas, cette propriété est utilisable uniquement dans l'événement "Ouverture" de l'état.
Remarque : Cette rubrique est définie lors de la création du champ ou de l'état. Cette rubrique peut être modifiée dans l'onglet "Données" de la description de l'élément.
Exemple
// -- Code d'ouverture de l'état
// Changement du fichier parcouru
ETAT_Etat1.NomSource = Client
// Nouvelle rubrique de parcours du fichier "Client"
ETAT_Etat1.RubriqueParcourue = IDClient
WEBDEV - Code ServeurAjax
// Tri décroissant sur les noms des sociétés
TABLE_TableClient.RubriqueParcourue = "-Société"
Syntaxe

Connaître la rubrique utilisée pour le parcours automatique dans un champ fichier Masquer les détails

<Rubrique parcourue> = <Champ manipulé>.RubriqueParcourue
<Rubrique parcourue> : Chaîne de caractères
Nom de la rubrique utilisée pour le parcours automatique du champ spécifié. Cette rubrique appartient au fichier de données parcouru par le champ (connu ou modifié grâce à la propriété FichierParcouru).
Si le signe "-" précède le nom de la rubrique, le parcours est effectué en sens décroissant.
<Champ manipulé> : Nom de champ
Nom du champ à manipuler.

Modifier la rubrique utilisée pour le parcours automatique dans un champ fichier Masquer les détails

<Champ manipulé>.RubriqueParcourue = <Nouvelle rubrique>
<Champ manipulé> : Nom de champ
Nom du champ à manipuler.
<Nouvelle rubrique> : Chaîne de caractères
Nom de la nouvelle rubrique à utiliser pour le parcours automatique du champ spécifié. Cette rubrique doit appartenir au fichier de données parcouru par le champ (connu ou modifié grâce à la propriété FichierParcouru).
Si le signe "-" précède le nom de la rubrique, le parcours sera effectué en sens décroissant.
WEBDEV - Code ServeurPHPAjax

Connaître la rubrique utilisée pour le parcours automatique d'un état fichier Masquer les détails

<Rubrique parcourue> = <Etat manipulé>.RubriqueParcourue
<Rubrique parcourue> : Chaîne de caractères
Nom de la rubrique utilisée pour le parcours automatique de l'état spécifié. Cette rubrique appartient au fichier de données parcouru par l'état (connu ou modifié grâce à la propriété NomSource).
<Etat manipulé> : Nom de l'état
Nom de l'état sur fichier à manipuler.
WEBDEV - Code ServeurPHPAjax

Modifier la rubrique utilisée pour le parcours automatique d'un état fichier Masquer les détails

<Etat manipulé>.RubriqueParcourue = <Nouvelle rubrique>
<Etat manipulé> : Nom de l'état
Nom de l'état sur fichier à manipuler.
<Nouvelle rubrique> : Chaîne de caractères
Nom de la nouvelle rubrique utilisée pour le parcours automatique de l'état spécifié. Cette rubrique doit appartenir au fichier de données parcouru par l'état (connu ou modifié grâce à la propriété NomSource).
Remarques

Type de parcours

  • Parcours automatique : Le parcours du fichier de données et l'affichage des données dans le champ sont automatiques. Le développeur n'a aucun code spécifique à saisir.
    Le tri est effectué sur la rubrique de parcours définie dans l'onglet "Contenu" de la description de l'objet. Si un filtre est spécifié ("Filtre sur la rubrique de parcours" dans l'onglet "Contenu" de la description de l'objet), ce filtre est utilisé. Aucun traitement de parcours de l'objet spécifié n'est exécuté.
  • Parcours programmé : Le développeur doit programmer le parcours du fichier de données et l'affichage des données dans le champ Table.
    Les traitements "Lecture du premier enregistrement", "Lecture de l'enregistrement précédent", "Lecture de l'enregistrement suivant" et "Lecture du dernier enregistrement" sont exécutés. 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.

Manipuler des champs liés à un fichier de données grâce aux propriétés

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

Modifier les propriétés liées au parcours d'un champ fichier

Pour modifier les 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.

Table par programmation

Si un champ Table par programmation doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue :
  • Créez un champ Table par programmation sous l'éditeur.
  • Dans le code de votre application, indiquez la rubrique à parcourir avec la propriété RubriqueParcourue. Cette rubrique doit appartenir au fichier de données, à la requête ou à la vue dont les données seront affichées dans le champ Table par programmation.
  • Utilisez la fonction FichierVersTableMémoire pour initialiser le champ Table avec les données voulues. Les données seront triées selon la rubrique parcourue spécifiée.
  • La propriété RubriqueAffichée sera automatiquement initialisée.

Champ Liste et champ Combo par programmation

Si un champ Liste ou Combo par programmation doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue :

Limites

La propriété RubriqueParcourue s'applique uniquement :
  • aux états dont la source de données est un fichier de données.
  • sur les champs (Liste, Table et Combo) d'une fenêtre.
WEBDEV - Code ServeurPHP Dans les pages, la propriété RubriqueParcourue s'applique uniquement aux champs suivants :
  • Champ Table,
  • Champ Zone répétée,
  • Champ Zone répétée linéaire,
  • Champ Liste,
  • Champ Combo,
  • Champ Planning.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 29/03/2023

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