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.

• correspond au nom du champ Liste.
• est initialisée avec l'indice de l'élément sélectionné dans le champ Liste.

Initialiser un élément

Pour initialiser un élément d'un champ Liste, utilisez la fonction ListeAjoute.

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. Exemple :

Sélectionner une ligne

Pour sélectionner l'élément de la ligne <Indice>, utilisez :

• soit l'affectation directe :
  
  <Champ Liste> = Indice
• soit la fonction ListeSelectPlus :
  
  ListeSelectPlus(<Champ Liste>, <Indice>)

Se positionner sur le dernier élément

Pour se positionner sur le dernier élément du champ Liste, utilisez :

• soit la propriété Occurrence :
  
  <Champ Liste>.Occurrence
• soit la fonction ListeSelectPlus associée à la propriété Occurrence :
  
  ListeSelectPlus(<Champ Liste>, <Champ Liste>.Occurrence)
• soit la fonction ListeOccurrence :
  
  ListeOccurrence(<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 = <Champ Liste>
• soit la fonction ListeSelect :
  
  Indice = ListeSelect(<Champ Liste>)

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 = <Champ Liste>
  <Variable> = <Champ Liste>[Indice]
• Syntaxe 2 :
  
  <Variable> = <Champ Liste>[<Champ Liste>]
• Syntaxe 3 : Propriété ValeurAffichée (en code serveur uniquement)
  
  <Variable> = <Champ Liste>[Indice].ValeurAffichée

L'instruction POUR TOUT permet d'effectuer différents types de parcours d'un champ Liste :

• Parcours des éléments du champ. La syntaxe utilisée est la suivante :
  
  POUR TOUTE LIGNE [<Indice> [, <Compteur>]] DE <Champ Liste>
   ...
  FIN
  où :
  • <Indice> : Variable optionnelle de type Entier. A chaque itération, contient l'indice de la ligne en cours.
  • <Compteur> : Variable optionnelle de type Entier. Cette variable compte le nombre d'itérations.
• Parcours des éléments des éléments sélectionnés. La syntaxe utilisée est la suivante :
  
  POUR TOUTE LIGNE SELECTIONNEE [<Indice>, [<Compteur>]] DE <Champ Liste>
     ...
  FIN
  où :
  • <Indice> : Variable de type Entier. A chaque itération, contient l'indice de la ligne sélectionnée en cours.
  • <Compteur> : Variable optionnelle de type Entier. Cette variable compte le nombre d'itérations (nombre de lignes sélectionnées par exemple).

Les propriétés suivantes sont spécifiques à la gestion des champs Liste :

Tout type de champs Liste
CadrageHorizontal	Permet de connaître et de modifier le cadrage horizontal des éléments du champ Liste.
HauteurLigne	Permet de connaître et de modifier la hauteur des lignes d'un champ Liste.
Mémoire	Permet de savoir si le champ spécifié est un champ Liste par programmation ou un champ Liste fichier.
Occurrence	Permet de connaître le nombre de lignes présentes dans un champ Liste.
TypeRemplissage	Permet de connaître le type de remplissage (liaison fichier, par programmation, liaison variable) d'un champ de type Table, Liste, Liste image, Combo ou Zone répétée.
ValeurAffichée	Permet de connaître la valeur de la ligne en cours ou d'une ligne spécifique du champ Liste.
ValeurMémorisée	Permet de connaître la valeur actuellement mémorisée lors de la sélection d'une ligne du champ Liste.
Vide	Permet de savoir si un champ Liste est vide.
Champ Liste par programmation uniquement
ContenuInitial	Permet de connaître le contenu initial d'un champ Liste par programmation.
Triée	Permet de savoir si un champ Liste par programmation est triée et de trier un champ Liste par programmation.
Champ Liste Fichier uniquement
FichierParcouru	Permet 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.
ParcoursAuto	Permet de savoir si le parcours d'un champ Liste fichier est automatique ou programmé.
RubriqueAffichée	Permet de connaître ou de modifier la rubrique affichée dans un champ Liste.
RubriqueMémorisée	Permet de connaître ou de modifier la rubrique mémorisée d'un champ Liste.
RubriqueParcourue	Permet de connaître et de modifier la rubrique utilisée pour le parcours automatique des champs Liste.

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.