PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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 mémoire, fichier et sur source
  • Table mémoire
  • Liste mémoire
  • Liste image
  • Limites
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
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.
WEBDEV - Code Serveur Cette modification est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "Détail" de la description du champ).
WEBDEV - Code Serveur Cette modification est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "IHM" de la description du champ).
Remarques :
  • Utilisée dans le traitement "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 le traitement "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 du traitement "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.
WINDEVWINDEV Mobile Pour un champ Liste Image, cette rubrique correspond au libellé affiché dans la liste image.
Versions 15 et supérieures
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les champs des états dans les applications iPhone/iPad.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les champs des états dans les applications iPhone/iPad.
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les champs des états dans les applications iPhone/iPad.
Versions 20 et supérieures
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
Nouveauté 20
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Exemple
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadAjaxCode Utilisateur (MCU)
// -- Ouverture de l'état
// Changement du fichier parcouru
ETAT_Etat1..NomSource = Client
// Nouvelle rubrique affichée dans le champ "NomCli"
NomCli..RubriqueAffichée = "NomClient"
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadAjaxCode Utilisateur (MCU)
// Changement du fichier de données associé à l'état
// Passage du fichier Client au fichier Prospect
ETAT_EtatClient..NomSource = Prospect
// Changement de la vue associée à l'état.
// Cette vue est basée sur le fichier Prospect.
ETAT_EtatClient..NomVue = MaVueClient84
NomCli..RubriqueAffichée = "NomProspect"
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileJavaAjaxCode Utilisateur (MCU)
// Modifier les rubriques affichées dans la table "TABLE_TableClient"
TABLE_TableClient..RubriqueAffichée = "PrénomClient|NomClient|CP|Ville"
// Modifier la rubrique affichée dans la liste "LISTE_ListeClient"
LISTE_ListeClient..RubriqueAffichée = "PrénomClient"
Syntaxe
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

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

<Rubrique / variable actuellement affichée> = <Nom du champ>..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'une table, liste des noms des rubriques ou des variables affichées par chaque colonne de la table. Les noms des rubriques / variables sont séparés par le caractère "|" (combinaison de touches [Alt Gr] + [6]).
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ (table, liste, liste image ou combo) à manipuler.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

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

<Nom du champ>..RubriqueAffichée = <Nouvelle rubrique / variable>
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ (table, liste, liste image ou combo) à manipuler.
<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'une table, liste des noms des rubriques ou des variables affichées par chaque colonne de la table. Les noms des rubriques / variables sont séparés par le caractère "|" (combinaison de touches [Alt Gr] + [6]).
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadAjaxCode Utilisateur (MCU)

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

<Rubrique actuellement affichée> = <Nom du champ>..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.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ de l'état à manipuler.
Dans un état, ce champ peut être :
  • un champ Image,
  • un champ Code-barres,
  • un champ Rich Edit,un champ Libellé de type RTF,
  • un champ Rubrique,un champ Libellé,
  • un champ Interrupteur,
  • Versions 15 et supérieures
    un champ Calculé.
    Nouveauté 15
    un champ Calculé.
    un champ Calculé.
  • Versions 21 et supérieures
    un champ Tableur
    Nouveauté 21
    un champ Tableur
    un champ Tableur
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadAjax

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

<Nom du champ>..RubriqueAffichée = <Nouvelle rubrique>
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ de l'état à manipuler.
Dans un état, ce champ peut être :
  • un champ Image,
  • un champ Code-barres,
  • un champ Rich Edit,un champ Libellé de type RTF,
  • un champ Rubrique,un champ Libellé,
  • un champ Interrupteur,
  • Versions 15 et supérieures
    un champ Calculé.
    Nouveauté 15
    un champ Calculé.
    un champ Calculé.
  • Versions 21 et supérieures
    un champ Tableur
    Nouveauté 21
    un champ Tableur
    un champ Tableur
<Nouvelle rubrique> : Chaîne de caractères avec guillemets
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
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

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.
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

Modifier la rubrique affichée dans les champs Table mémoire, fichier et sur source

Si le paramètre <Nouvelle rubrique / variable> contient :
  • Un nombre de rubriques supérieur au nombre de colonnes de la table, seules les premières rubriques (ou variables) sont associées aux colonnes existantes de la table.
  • Un nombre de rubriques inférieur au nombre de colonnes de la 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.
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

Table mémoire

Si un champ Table mémoire 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 mémoire 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 mémoire.
  • 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.
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileUniversal Windows 10 AppiPhone/iPadAjaxCode Utilisateur (MCU)

Liste mémoire

Si un champ Liste ou Combo mémoire doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue :
WINDEVWINDEV MobileWindows MobileJavaCode Utilisateur (MCU)

Liste image

Dans le cas d'une 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

WINDEVWINDEV MobileJava Dans les fenêtres, la propriété ..RubriqueAffichée s'applique uniquement aux :
  • tables,
  • listes (ou listes image),
  • combos.
WEBDEV - Code Serveur Dans les pages, la propriété ..RubriqueAffichée s'applique uniquement aux :
  • tables,
  • zones répétées,
  • listes,
  • combos.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPad Dans les états, la propriété ..RubriqueAffichée s'applique uniquement aux champs suivants :
  • champ Image,
  • champ Code-barres,
  • champ Rich Edit,champ Libellé de type RTF,
  • champ Rubrique,champ Libellé,
  • champ Interrupteur,
  • Versions 15 et supérieures
    champ calculé.
    Nouveauté 15
    champ calculé.
    champ calculé.
  • Versions 21 et supérieures
    champ Tableur
    Nouveauté 21
    champ Tableur
    champ Tableur
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Combo Table fichier doit être associée à un fichier
Soit une combo fichier qui n'est pas reliée à un fichier de l'analyse (exemple : gpwlogin).

Elle est reliée au fichier par programmation :
// description de la combo
Login..RubriqueParcourue = "Login"
Login..RubriqueAffichee = "Login"
Login..RubriqueMémorisée = "Login"
Login..FichierParcouru = "GPWUtilisateur"

Vous transformez la combo liste fichier en une combo table fichier (ajout de 2 colonnes).
Le nouveau code est :
// description de la combo
Login..RubriqueParcourue = "Login"
Login..RubriqueAffichée = "Login|Nom|Prenom"
Login..RubriqueMémorisée = "Login"
Login..FichierParcouru = "GPWUtilisateur"

Testez : la combo est vide.

Pour la faire fonctionner, il faut impérativement relier la combo à N'IMPORTE quel fichier de l'analyse (ridicule !)


Pour info, si l'on veut éditer les colonnes (et seulement dans ce cas), le message suivant apparaît :
"Il est nécessaire de choisir la source parcourue avant de pouvoir éditer les colonnes."
Jean-Pierre BLOCH (
24 mar. 2010