PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • 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 WatchCatalystUniversal Windows 10 AppWindows Mobile
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 de la liste a été utilisé).
Remarque : La fonction ListePosition peut être utilisée indifféremment sur :
  • les champs Liste fichier ou mémoire,
  • les champs Liste monosélection ou multisélection.
WEBDEV - Code Serveur Cette fonction n'a aucun effet.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
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 : wd260obj.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire