RubriqueAffichée (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs

Manipuler des champs Table, Zone répétée, Liste (y compris Liste image) et Combo fichier grâce aux propriétés
Modifier la rubrique affichée dans les champs Table par programmation, Table fichier et Table sur variable
Champ Table par programmation
Champ Liste par programmation
Champ Liste image
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

RubriqueAffichée (Propriété)

En anglais : DisplayedItem

La propriété RubriqueAffichée permet de :

Connaître la rubrique ou la variable affichée par le champ.
Modifier la rubrique ou la variable affichée par le champ.

Remarques :

Utilisée dans l'événement "Ouverture" de l'état, cette propriété permet de modifier la rubrique affichée dans un champ lorsque la source de données de l'état a été modifiée par programmation (avec la propriété NomSource par exemple).
Si cette propriété est utilisée dans l'événement "Avant impression" du champ, le changement ne sera effectué qu'à la prochaine impression du champ (en effet, la valeur de la rubrique est déjà lue lors de l'exécution de l'événement "Avant impression" du champ).
La rubrique affichée peut provenir d'un fichier de données, d'une vue ou d'une requête.
La rubrique mémorisée ou la variable mémorisée est définie sous l'éditeur de fenêtres ou pages dans l'onglet "Contenu" de la description du champ.

Pour un champ Liste image, cette rubrique correspond au libellé affiché dans le champ Liste image.

Exemple

// -- Ouverture de l'état
// Changement du fichier de données parcouru
ETAT_Etat1.NomSource = Client
// Nouvelle rubrique affichée dans le champ "NomCli"
NomCli.RubriqueAffichée = "NomClient"

// Changement du fichier de données associé à l'état
// Passage du fichier de données Client au fichier de données Prospect
ETAT_EtatClient.NomSource = Prospect
// Changement de la vue associée à l'état.
// Cette vue est basée sur le fichier de données Prospect
ETAT_EtatClient.NomVue = MaVueClient84
NomCli.RubriqueAffichée = "NomProspect"

// Modifier les rubriques affichées dans le champ Table "TABLE_TableClient"
TABLE_TableClient.RubriqueAffichée = "PrénomClient|NomClient|CP|Ville"

// Modifier la rubrique affichée dans le champ Liste "LISTE_ListeClient"
LISTE_ListeClient.RubriqueAffichée = "PrénomClient"

Syntaxe

Connaître la rubrique / variable affichée par un champ Table, Liste ou Combo Masquer les détails

<Rubrique / variable actuellement affichée> = <Champ manipulé>.RubriqueAffichée

<Rubrique / variable actuellement affichée> : Chaîne de caractères

Nom de la rubrique affichée par le 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 affichée par le 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).
Dans le cas d'un champ Table, liste des noms des rubriques ou des variables affichées par chaque colonne du champ Table. Les noms des rubriques / variables sont séparés par le caractère "|" (combinaison de touches AltGr + 6).

<Champ manipulé> : Nom de champ

Nom du champ à manipuler : Table, Liste, Liste image ou Combo.

Modifier la rubrique / variable affichée par un champ Table, Liste ou Combo Masquer les détails

<Champ manipulé>.RubriqueAffichée = <Nouvelle rubrique / variable>

<Champ manipulé> : Nom de champ

Nom du champ à manipuler : Table, Liste, Liste image ou Combo.

<Nouvelle rubrique / variable> : Chaîne de caractères

Nom de la rubrique à afficher dans le 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 à afficher dans le 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).
Dans le cas d'un champ Table, liste des noms des rubriques ou des variables affichées par chaque colonne du champ Table. Les noms des rubriques / variables sont séparés par le caractère "|" (combinaison de touches AltGr + 6).

Connaître la rubrique affichée par un champ de l'état Masquer les détails

<Rubrique actuellement affichée> = <Champ manipulé>.RubriqueAffichée

<Rubrique actuellement affichée> : Chaîne de caractères

Nom de la rubrique associée au champ spécifié. Pour une liaison multi-fichiers, le nom de la rubrique est du type :
<Nom Fichier1>.<Nom de la rubrique> + TAB + <Nom Fichier2>.<Nom de la rubrique>
Cette rubrique correspond :
soit à une rubrique appartenant au fichier source de données de l'état (connu ou modifié grâce à la propriété NomSource).
soit à une rubrique (ou à son alias) appartenant à la requête source de données de l'état.

<Champ manipulé> : Nom de champ

Nom du champ de l'état à manipuler.
Dans un état, ce champ peut être :
un champ Image,
un champ Code-barres,
un champ Libellé de type RTF,
un champ Libellé,
un champ Interrupteur,
un champ Calculé.
un champ Tableur

Modifier la rubrique affichée par un champ de l'état Masquer les détails

<Champ manipulé>.RubriqueAffichée = <Nouvelle rubrique>

<Champ manipulé> : Nom de champ

Nom du champ de l'état à manipuler.
Dans un état, ce champ peut être :
un champ Image,
un champ Code-barres,
un champ Libellé de type RTF,
un champ Libellé,
un champ Interrupteur,
un champ Calculé.
un champ Tableur

<Nouvelle rubrique> : Chaîne de caractères

Nom de la nouvelle rubrique associée au champ spécifié. Pour une liaison multi-fichier, le nom de la rubrique est du type :
<Nom Fichier1>.<Nom de la rubrique> + TAB + <Nom Fichier2>.<Nom de la rubrique>
Cette rubrique correspond :
soit à une rubrique appartenant au fichier source de données de l'état (connu ou modifié grâce à la propriété NomSource).
soit à une rubrique (ou à son alias) appartenant à la requête source de données de l'état.

Remarques

Manipuler des champs Table, Zone répétée, Liste (y compris Liste image) et Combo fichier grâce aux propriétés

Les enregistrements affichés dans un champ Liste, Table, Zone répétée ou Combo fichier proviennent du fichier de données ou de la requête spécifiée 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 la rubrique affichée dans les champs Table par programmation, Table fichier et Table sur variable

Si le paramètre <Nouvelle rubrique / variable> contient :

Un nombre de rubriques supérieur au nombre de colonnes du champ Table, seules les premières rubriques (ou variables) sont associées aux colonnes existantes du champ Table.
Un nombre de rubriques inférieur au nombre de colonnes du champ Table, les colonnes "supplémentaires" ne sont associées à aucune rubrique (ou variable).

Remarque : Pour associer une colonne avec une rubrique ou une variable, utilisez la propriété LiaisonFichier.

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.
Dans votre programme, 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 par programmation

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

Champ Liste image

Dans le cas d'un champ Liste image, la propriété RubriqueAffichée permet de connaître et de modifier uniquement la rubrique correspondant aux libellés des éléments affichés dans le champ.

Pour connaître et modifier la rubrique correspondant aux images affichées dans le champ, utilisez la propriété RubriqueAffichéeImage.

Limites

Dans les fenêtres, la propriété RubriqueAffichée s'applique uniquement aux champs suivants :

champ Table,
champ Liste (ou champ Liste image),
champ Combo.

Dans les pages, la propriété RubriqueAffichée s'applique uniquement aux champs suivants :

champ Table,
champ Zone répétée,
champ Liste,
champ Combo.

Dans les états, la propriété RubriqueAffichée s'applique uniquement aux champs suivants :

champ Image.
champ Code-barres.
champ Libellé de type RTF.
champ Libellé.
champ Interrupteur.
champ calculé.
champ Tableur.

Voir Aussi

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