WINDEV permet de manipuler un champ Liste image directement par programmation. Il suffit d'utiliser directement la variable du champ Liste image dans le code. Cette variable est de type numérique.

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

Initialiser un élément

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

Remplir un champ Liste image

Pour initialiser un champ Liste image, il suffit d'utiliser une boucle d'itération pour initialiser tous les éléments du champ.

Sélectionner l'élément de la ligne <Indice>

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

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

Se positionner sur le dernier élément du champ Liste image

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

• soit la propriété Occurrence :
  
  <Champ Liste image>.Occurrence
• soit la fonction ListeSelectPlus associée à la propriété Occurrence :
  
  ListeSelectPlus(<Champ Liste image>, <Champ Liste image>.Occurrence)
• soit la fonction ListeOccurrence :
  
  ListeOccurrence(<Champ Liste image>)

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 image>
• soit la fonction ListeSelect :
  
  Indice = ListeSelect(<Champ Liste image>)

Remarque : Pour les champs Liste image multisélection, la fonction ListeSelect permet de récupérer les éléments sélectionnés.

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 suivants :

• Syntaxe 1 :
  
  Indice est un entier = <Champ Liste image>
  <Variable> = <Champ Liste image>[Indice]
• Syntaxe 2 :
  
  <Variable> = <Champ Liste image>[<Champ Liste image>]
• Syntaxe 3 : Propriété ValeurAffichée
  
  <Variable> = <Champ Liste image>.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 image, utilisez la propriété ValeurMémorisée.

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

Tout type de champ Liste image
Mémoire	Permet de savoir si le champ spécifié est un champ Liste image par programmation ou Liste image fichier.
ModeListeImage	Change le mode d'affichage du champ Liste image (mode liste image, mode liste classique, mode panorama).
Occurrence	Permet de connaître le nombre de lignes présentes dans un champ Liste image.
OrientationVerticale	Permet de connaître et de modifier l'orientation d'un champ Liste image.
TypeRemplissage	Permet de connaître le type de remplissage (fichier, par programmation, sur variable) d'un champ Liste image.
ValeurAffichée	Permet de connaître la valeur de la ligne en cours ou d'une ligne spécifique du champ Liste image.
Vide	Permet de savoir si un champ Liste image est vide.
Champ Liste image par programmation uniquement
Triée	Permet de savoir si un champ Liste image par programmation est triée et de trier un champ Liste image par programmation (tri réalisé en fonction des libellés des éléments).
Champ Liste image 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 image fichier.
ParcoursAuto	Permet de savoir si le parcours d'un champ Liste image fichier est automatique ou programmé.
RubriqueAffichée	Permet de connaître ou de modifier la rubrique correspondant au libellé affiché dans un champ Liste image.
RubriqueAffichéeImage	Permet de connaître ou de modifier la rubrique correspondant à l'image affichée dans un champ Liste image.
RubriqueMémorisée	Permet de connaître ou de modifier la rubrique mémorisée d'un champ Liste image.
RubriqueParcourue	Permet de connaître et de modifier la rubrique utilisée pour le parcours automatique des champs Liste image.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Liste image, consultez Propriétés associées au champ Liste image.