Renvoie l'indice de l'élément sélectionné dans un champ Liste, Liste image ou Combo.
Rappel : L'élément sélectionné correspond à l'élément en cours sur lequel le bandeau de sélection est affiché.
Remarque : La fonction ListeSelect peut être utilisée indifféremment sur :
- les champs Liste fichier ou Liste par programmation,
- les champs Liste monosélection ou multisélection.
// Indice de l'élément sélectionné dans le champ "LISTE_ListeClient"
ResIndiceElément = ListeSelect(LISTE_ListeClient)
// Lignes sélectionnées dans un champ Liste multisélection
i est un entier = 1
IndiceLigneSelectionnee est un entier
IndiceLigneSelectionnee = ListeSelect(LISTE_Liste1, 1)
TANTQUE IndiceLigneSelectionnee <> -1
Trace("La ligne n°" + IndiceLigneSelectionnee + " est sélectionnée")
i++
IndiceLigneSelectionnee = ListeSelect(LISTE_Liste1, i)
FIN
// Équivalent à :
// POUR TOUTE LIGNE SELECTIONNEE DE LISTE_Liste1
// Trace("La ligne n°" + LISTE_Liste1 + " est sélectionnée")
// FIN
Syntaxe
<Résultat> = ListeSelect(<Champ Liste> [, <Rang>])
<Résultat> : Entier
- Indice de l'élément sélectionné dans le champ Liste (ou Combo) spécifiée,
- -1 si aucun élément n'est sélectionné.
Dans le cas d'un champ Liste multisélection, il est nécessaire de préciser le rang de l'élément sélectionné (paramètre <Rang>).
<Champ Liste> : Nom de champ
Nom du champ Liste (ou Combo) à manipuler. Si ce paramètre correspond à une chaîne vide (""), l'indice de l'élément sélectionné dans le champ Liste (ou Combo) auquel appartient l'événement en cours est renvoyé.
<Rang> : Entier optionnel
Rang de la sélection dans le cas d'un champ Liste multisélection. Si ce paramètre n'est pas spécifié, l'indice du premier élément sélectionné est renvoyé.Par exemple : Pour récupérer le premier élément sélectionné, le rang sera 1, pour récupérer le deuxième élément sélectionné, le rang sera 2, etc.
Remarques
Équivalence
Les syntaxes suivantes sont équivalentes :
Indice est un entier
Indice = <Champ Liste>
et
Indice = ListeSelect(<Champ Liste>)
Valeur de l'élément sélectionné
Pour récupérer la valeur de l'élément sélectionné, la syntaxe est :
Indice est un entier
Indice = ListeSelect(<Champ Liste>)
<Valeur de l'élément> = <Champ Liste>[Indice]
et
<Valeur de l'élément> = <Champ Liste>[<Champ Liste>]
Divers
- Pour connaître l'indice de l'élément sélectionné dans un champ Table, utilisez la fonction TableSelect.
- La fonction ListeSelect peut être utilisée sur une colonne d'un champ Table de type "Combo".
Composante : wd280obj.dll