DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Liste
  • Afficher un élément au début d'un champ Liste (syntaxe 1)
  • Limitations
  • Divers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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.
Exemple
// 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 : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale