Sélectionne un ou plusieurs éléments dans un champ Liste, Liste image ou Combo.
L'élément est sélectionné mais n'est pas affiché s'il n'est pas visible. Pour rendre l'élément sélectionné visible, utilisez la fonction
ListePosition.
Rappel : L'élément sélectionné correspond à l'élément en cours sur lequel le bandeau de sélection est affiché.
Remarque : La fonction ListeSelectPlus peut être utilisée indifféremment sur :
- les champs Liste fichier ou Liste par programmation,
- les champs Liste monosélection ou multisélection.
// Sélection de l'élément dont l'indice est 7 dans le champ "LISTE_ListeClient"
ListeSelectPlus(LISTE_ListeClient, 7)
Syntaxe
ListeSelectPlus(<Champ Liste> [, <Indice 1> [... [, <Indice N>]]])
<Champ Liste> : Nom de champ
Nom du champ Liste (ou Combo) à manipuler.
Si ce paramètre correspond à une chaîne vide (""), l'élément spécifié selon son indice est sélectionné dans le champ Liste (ou Combo) auquel appartient l'événement en cours.
<Indice 1> : Entiers optionnels
Indice du premier élément à sélectionner.
Si aucun indice n'est précisé, tous les éléments du champ Liste (ou Combo) spécifié sont sélectionnés.
Si ces paramètres correspondent à des éléments déjà sélectionnés, la fonction ListeSelectPlus est sans effet.
<Indice N> : Entier optionnel
Indice du Nième élément à sélectionner.
Si aucun indice n'est précisé, tous les éléments du champ Liste (ou Combo) spécifié sont sélectionnés.
Si ces paramètres correspondent à des éléments déjà sélectionnés, la fonction ListeSelectPlus est sans effet.
Remarques
Dernier élément
Pour se positionner sur le dernier élément d'un champ Liste, la syntaxe est :
ListeSelectPlus(<Champ Liste>, <Champ Liste>.Occurrence)
ou
<Champ Liste> = <Champ Liste>.Occurrence
ou
<Champ Liste> = ListeOccurrence(<Champ Liste>)
Équivalence
Dans le cas d'un champ Liste monosélection sans l'utilisation de la fonction
gValeurMémorisée, les deux syntaxes suivantes sont équivalentes :
ListeSelectPlus(<Champ Liste>, <Indice>)
Divers
- Pour sélectionner un élément dans un champ Table, utilisez la fonction TableSelectPlus.
- La fonction ListeSelectPlus peut être utilisée sur une colonne d'un champ Table de type "Combo".
- La fonction ListeSelectMoins permet de désélectionner les éléments d'un champ Liste ou d'un champ Combo.
Composante : wd280obj.dll