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 à une table 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
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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 à une table.
  • Modifier la rubrique utilisée pour le parcours automatique des champs liés à une table. Le parcours est alors réinitialisé.
Pour un état sur table, la propriété RubriqueParcourue permet de modifier la rubrique utilisée pour le parcours de la table. 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 de la table parcourue
ETAT_Etat1.NomSource = Client 
// Nouvelle rubrique de parcours de la table "Client"
ETAT_Etat1.RubriqueParcourue = IDClient
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 à la table parcourue par le champ (connu ou modifié grâce à la propriété TableParcourue).
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 à la table parcourue par le champ (connu ou modifié grâce à la propriété TableParcourue).
Si le signe "-" précède le nom de la rubrique, le parcours sera effectué en sens décroissant.
Etats et Requêtes

Connaître la rubrique utilisée pour le parcours automatique d'un état sur table 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 à la table parcourue par l'état (connue ou modifiée grâce à la propriété NomSource).
<Etat manipulé> : Nom de l'état
Nom de l'état sur table à manipuler.
Etats et Requêtes

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

<Etat manipulé>.RubriqueParcourue = <Nouvelle rubrique>
<Etat manipulé> : Nom de l'état
Nom de l'état sur table à 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 à la table parcourue par l'état (connue ou modifiée grâce à la propriété NomSource).
Remarques

Type de parcours

  • Parcours automatique: Le parcours de la table 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 de la table 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 à une table grâce aux propriétés

  • Les enregistrements affichés dans un champ lié à une table proviennent de la table ou de la requête spécifié avec la propriété TableParcourue.
  • 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 TableParcourue, il est conseillé de:
  1. Stopper le parcours en affectant une chaîne vide ("") à la propriété TableParcourue.
  2. Modifier les propriétés nécessaires.
  3. Relancer le parcours avec la propriété TableParcourue.
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.

Table par programmation

Si un champ Table par programmation doit afficher des données provenant d'une table, 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 à la table, à 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'une table, 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 une table.
  • sur les champs (Liste, Table et Combo) d'une fenêtre.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/12/2024

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