PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Initialiser un champ Liste
  • Initialiser un élément
  • Remplir un champ Liste
  • Sélectionner un élément dans un champ Liste
  • Sélectionner une ligne
  • Se positionner sur le dernier élément
  • Récupérer l'élément sélectionné dans un champ Liste
  • Récupérer l'indice de l'élément sélectionné
  • Récupérer la valeur de l'élément sélectionné
  • Propriétés spécifiques à la gestion des champs Liste
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
WINDEV, WEBDEV et WINDEV Mobile permettent de manipuler un champ Liste directement par programmation. Il suffit d'utiliser directement la variable du champ Liste dans le code. Cette variable est de type numérique.
La variable du champ Liste :
  • correspond au nom du champ Liste.
  • est initialisée avec l'indice de l'élément sélectionné dans la liste.
Pour manipuler un élément de la liste, il suffit d'utiliser la notation suivante :
<Nom du champ Liste> [<Indice de l'élément>]
Remarque : De nombreuses fonctions du WLangage sont spécifiques à la gestion des champs de type Liste. Pour plus de détails, consultez les fonctions de gestion des listes.
Initialiser un champ Liste

Initialiser un élément

Pour initialiser un élément d'un champ Liste, utilisez la fonction ListeAjoute.
Remarque : Pour modifier un élément d'un champ Liste, il est possible d'utiliser la syntaxe :
<Nom Liste>[Indice] = <valeur>
Par exemple :
// Ajout d'éléments
ListeAjoute(LISTE_LISTE1, "DUPOND")
ListeAjoute(LISTE_LISTE1, Nom_Cli)
// Modification d'éléments
LISTE_LISTE1[3] = "DUPONT"

Remplir un champ Liste

Pour initialiser un champ Liste, il suffit d'utiliser une boucle d'itération pour initialiser tous les éléments du champ Liste.
Indice est un entier
POUR Indice = <Position Début> A <Position Fin>
ListeAjoute(<Nom Liste>, <Valeur>)
FIN
Exemple :
i est un entier
POUR i = 1 A 52
        ListeAjoute(LISTE_LISTE1, NOM[i])
FIN
Sélectionner un élément dans un champ Liste

Sélectionner une ligne

Pour sélectionner l'élément de la ligne <Indice>, utilisez :
  • soit l'affectation directe :
    <Nom Liste> = Indice
  • soit la fonction ListeSelectPlus :
    ListeSelectPlus(<Nom Liste>, <Indice>)

Se positionner sur le dernier élément

Pour se positionner sur le dernier élément du champ Liste, utilisez :
Récupérer l'élément sélectionné dans un champ Liste

Récupérer l'indice de l'élément sélectionné

Pour récupérer l'indice de l'élément sélectionné, utilisez :
  • soit la lecture directe de l'élément :
    Indice = <Nom Liste>
  • soit la fonction ListeSelect :
    Indice = ListeSelect(<Nom Liste>)
Remarque : Pour les champs Liste multi-sélection, la fonction ListeSelect permet de récupérer les éléments sélectionnés.
// Récupérer les éléments d'une liste mutisélection
Rang est un entier = 0  // numéro de la sélection
Indice est un entier = 0  // indice de l'élément sélectionné
BOUCLE
Rang = Rang + 1
Indice = ListeSelect(LISTE_LISTE1, Rang)
SI Indice = -1 ALORS SORTIR
FIN

Récupérer la valeur de l'élément sélectionné

Pour récupérer la valeur de l'élément sélectionné, utilisez une des syntaxes suivantes :
  • Syntaxe 1 :
    Indice est un entier = <Nom Liste>
    <Variable> = <Nom Liste>[Indice]
  • Syntaxe 2 :
    <Variable> = <Nom Liste>[<Nom Liste>]
  • Syntaxe 3 : Propriété ..ValeurAffichée (en code serveur uniquement)
    <Variable> = <Nom Liste>[Indice]..ValeurAffichée
Attention : La valeur mémorisée en programmation peut être différente de la valeur affichée. Pour connaître la valeur mémorisée correspondant à une des lignes du champ Liste, utilisez la propriété ..ValeurMémorisée.
Propriétés spécifiques à la gestion des champs Liste
Les propriétés suivantes sont spécifiques à la gestion des champs Liste :
Tout type de champs Liste
CadrageHorizontalPermet de connaître et de modifier le cadrage horizontal des éléments du champ Liste.
HauteurLignePermet de connaître et de modifier la hauteur des lignes d'un champ Liste.
MémoirePermet de savoir si le champ spécifié est un champ Liste mémoire ou fichier.
OccurrencePermet de connaître le nombre de lignes présentes dans un champ Liste.
TypeRemplissagePermet de connaître le type de remplissage (fichier, mémoire, variable) d'un champ de type Table, Liste, Liste image, Combo ou Zone répétée.
ValeurAffichéePermet de connaître la valeur de la ligne en cours ou d'une ligne spécifique du champ Liste.
ValeurMémoriséePermet de connaître la valeur actuellement mémorisée lors de la sélection d'une ligne du champ Liste.
VidePermet de savoir si un champ Liste est vide.
Liste mémoire uniquement
ContenuInitialPermet de connaître le contenu initial d'un champ Liste mémoire.
TriéePermet de savoir si un champ Liste mémoire est triée et de trier un champ Liste mémoire.
Liste Fichier uniquement
FichierParcouruPermet de connaître et de modifier le fichier de données ou la requête utilisé pour l'affichage des enregistrements dans les champs Liste fichier.
ParcoursAutoPermet de savoir si le parcours d'un champ Liste fichier est automatique ou programmé.
RubriqueAffichéePermet de connaître ou de modifier la rubrique affichée dans un champ Liste.
RubriqueMémoriséePermet de connaître ou de modifier la rubrique mémorisée d'un champ Liste.
RubriqueParcouruePermet de connaître et de modifier la rubrique utilisée pour le parcours automatique des champs Listes.
Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Liste, consultez Propriétés associées au champ Liste.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire