Affiche un champ Liste (y compris champ Liste image) à partir d'un élément spécifié ou renvoie l'indice du premier élément affiché dans un champ Liste (lorsque l'ascenseur du champ a été utilisé).
Remarque : La fonction ListePosition peut être utilisée indifféremment sur :
- les champs Liste fichier ou les champs Liste par programmation,
- les champs Liste monosélection ou multisélection.
// Indice du premier élément affiché dans le champ Liste "LISTE_ListeClient"
ResPosition = ListePosition(LISTE_ListeClient)
Syntaxe
Afficher un champ Liste à partir d'un élément spécifié Masquer les détails
ListePosition(<Champ Liste> , <Indice de l'élément>)
<Champ Liste> : Nom de champ
Nom du champ Liste à manipuler.
Si ce paramètre correspond à une chaîne vide (""), l'élément est affiché au début du champ Liste auquel appartient l'événement en cours.
<Indice de l'élément> : Entier
Indice de l'élément à afficher au début du champ Liste.
Si ce paramètre est supérieur au nombre d'éléments présents dans le champ Liste (connu avec la fonction ListeOccurrence), une erreur WLangage est affichée.Si ce paramètre est égal à -1, le champ Liste est repositionnée au début.
Connaître l'indice du premier élément affiché dans un champ Liste ou Combo Masquer les détails
<Résultat> = ListePosition(<Champ Liste>)
<Résultat> : Entier
Indice du premier élément affiché dans le champ Liste spécifié.
<Champ Liste> : Nom de champ
Nom du champ Liste à manipuler.
Si ce paramètre correspond à une chaîne vide (""), l'indice du premier élément du champ Liste auquel appartient l'événement en cours est renvoyé.
Remarques
Afficher un élément au début d'un champ Liste (syntaxe 1)
L'élément affiché au début d'un champ Liste peut être différent de l'élément demandé. En effet, la fonction
ListePosition place au début du champ l'élément permettant de visualiser un maximum de lignes dans le champ. S'il n'y a pas assez d'éléments affichés en-dessous de l'élément spécifié, cet élément ne pourra pas être affiché au début du champ.
Par exemple, l'élément "Durand Jacques" ne peut pas être affiché au début du champ Liste : il n'y a pas assez d'éléments affichés en-dessous de cet élément.
Limitations
La fonction
ListePosition ne fonctionne pas pour les champs Liste fichier en mode "manuel" qui utilisent un ascenseur à rebond.
Rappel :
- Un champ Liste fichier en mode "manuel" est un champ Liste relié par programmation à un fichier de données.
- Avec un ascenseur à rebond, il est possible de faire défiler l'ascenseur en gardant le bouton de la souris enfoncé sur le bouton de l'ascenseur ou en gardant la touche flèche haut ou flèche bas enfoncée.
Divers
- Pour afficher un élément au début d'un champ Table ou pour connaître l'indice du premier élément affiché dans un champ Table, utilisez la fonction TablePosition.
- La fonction ListePosition peut être utilisée sur une colonne d'un champ Table de type "Combo".
Composante : wd280obj.dll