|
|
|
|
|
|
|
|
|
|
- Propriété Valeur
- Propriété LiaisonFichier
- Champ Table par programmation
- Champ Liste par programmation
- Recherche et sélection d'un élément présent dans un champ Liste fichier ou dans un champ Combo fichier
- Limites
RubriqueMémorisée (Propriété) En anglais : StoredItem
La propriété RubriqueMémorisée permet de : - Connaître la rubrique mémorisée ou la variable mémorisée d'un champ Table, Zone répétée, Liste ou Combo.
- Modifier la rubrique mémorisée ou la variable mémorisée d'un champ Table, Zone répétée, Liste ou Combo.
Remarques : - La rubrique mémorisée est utilisée pour les champs associés à un fichier de données ou une requête. La variable mémorisée est utilisée pour les champs associés à une variable.
- La rubrique mémorisée ou la variable mémorisée est définie sous l'éditeur de fenêtres ou sous l'éditeur de pages dans l'onglet "Contenu" de la description du champ.
// Modifier la rubrique mémorisée du champ "TABLE_TableClient"
TABLE_TableClient.RubriqueMémorisée = "NomClient"
Syntaxe
Connaître la rubrique/variable mémorisée d'un champ Masquer les détails
<Rubrique/variable mémorisée> = <Champ manipulé>.RubriqueMémorisée
<Rubrique/variable mémorisée> : Chaîne de caractères - Nom de la rubrique mémorisée 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).
- Nom de la variable mémorisée du champ spécifié. Ce nom est de la forme ":<préfixe><Nom de la variable>" ou ":<Nom de la variable>" (le préfixe est présent uniquement si la charte de programmation est activée dans le projet).
Cette variable appartient à la variable parcourue par le champ (connu ou modifié grâce à la propriété FichierParcouru). - Chaîne vide ("") si aucune rubrique/variable mémorisée n'est associée au champ.
<Champ manipulé> : Nom de champ Nom du champ à manipuler : - Champ Table,
- Champ Liste,
- Champ Combo.
Modifier la rubrique/variable mémorisée d'un champ Masquer les détails
<Champ manipulé>.RubriqueMémorisée = <Nouvelle rubrique/variable>
<Champ manipulé> : Nom de champ Nom du champ à manipuler : - Champ Table,
- Champ Liste,
- Champ Combo.
<Nouvelle rubrique/variable> : Chaîne de caractères - Nom de la nouvelle rubrique mémorisée 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).
- Nom de la nouvelle variable mémorisée du champ spécifié. Ce nom est de la forme ":<préfixe><Nom de la variable>" ou ":<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).
Cette variable appartient à la variable parcourue par le champ (connu ou modifié grâce à la propriété FichierParcouru). - Chaîne vide ("") si aucune rubrique/variable mémorisée ne doit être associée au champ.
Remarques Propriété Valeur La propriété RubriqueMémorisée modifie la valeur retournée par la propriété Valeur. Deux cas distincts se présentent : - Le champ Liste (ou champ Table) est un champ manipulé par programmation OU la propriété RubriqueMémorisée correspond à une chaîne vide (""). La propriété Valeur permet de :
- Connaître la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne -1. Si le champ Liste (ou le champ Table) est multisélection, le numéro de la dernière ligne sélectionnée est renvoyé.
- Déplacer la sélection en indiquant le numéro de la nouvelle ligne à sélectionner. La ou les lignes précédemment sélectionnées sont dé-sélectionnées.
Pour connaître la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
ResLigne = <Champ Liste ou champ Table>.Valeur
ResLigne = <Champ Liste ou champ Table>
- Le champ Liste (ou champ Table) est un champ lié à un fichier de données ET la propriété RubriqueMémorisée n'est pas une chaîne vide (""). La propriété Valeur permet de connaître la rubrique mémorisée pour l'enregistrement associé à la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne une chaîne vide ("").
Pour connaître la rubrique mémorisée associée à la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
ResRubMem = <Champ Liste ou champ Table>.Valeur
ResRubMem = <Champ Liste ou champ Table>.RubriqueMémorisée
Propriété LiaisonFichier La propriété RubriqueMémorisée est souvent utilisée en association avec la propriété LiaisonFichier. Cette association permet de créer une liaison automatique entre deux fichiers de données lors de l'appel des fonctions FichierVersEcran et EcranVersFichier. Champ 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 de fenêtres ou sous l'éditeur de pages.
- Dans le code, 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.
- Dans le code, indiquez la rubrique à mémoriser avec la propriété RubriqueMémorisée. 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 par programmation Si un champ Liste par programmation ou un champ Combo par programmation doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue : Recherche et sélection d'un élément présent dans un champ Liste fichier ou dans un champ Combo fichier Pour rechercher et/ou sélectionner un élément présent dans un champ Liste fichier ou dans un champ Combo fichier, il est conseillé d'utiliser la syntaxe suivante :
LISTE_ListeCommande.RubriqueMémorisée = "IDClient"
// Recherche et sélection de l'élément dont le IDClient est "135"
LISTE_ListeCommande = 135
// Si l'élément recherché n'est pas trouvé, LISTE_ListeCommande vaudra -1 Limites La propriété RubriqueMémorisée s'applique uniquement aux champs suivants : - champ Table,
- champ Liste,
- champ Combo,
 champ Zone répétée.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|