// -- 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
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.
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 :
- 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.
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.