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
  • 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
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
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.
    RubriqueMémorisée
Exemple
// 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 :
  • Créez un champ Liste par programmation ou le champ Combo par programmation sous l'éditeur de fenêtres ou sous l'éditeur de pages.
  • Utilisez la fonction FichierVersListeMémoire pour initialiser le champ avec les données voulues.
  • Les propriétés FichierParcouru, RubriqueAffichée, RubriqueParcourue et RubriqueMémorisée seront automatiquement initialisées.

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,
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 15/12/2023

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