DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Liste
  • Présentation du champ Liste
  • Créer un champ Liste
  • Vocabulaire
  • Notes
  • Champ Liste fichier ou champ Liste sur variable : Nombre de lignes
  • Limites en Java
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
Présentation du champ Liste
Le champ Liste permet d'afficher une liste d'éléments et de sélectionner un ou plusieurs éléments dans cette liste.
La liste est déroulée, c'est-à-dire que plusieurs éléments de la liste sont affichés dans la fenêtre ou la page.
WINDEVWINDEV Mobile Sous WINDEV et WINDEV Mobile, les champs Liste suivants sont disponibles :
Champ Liste texte
Champ Liste combinant images et texte.
Champ Liste multicolonne graphique permettant de sélectionner facilement une couleur
WEBDEV - Code Serveur Sous WEBDEV, les champs Liste ont le format suivant :
Les éléments d'un champ Liste peuvent :
  • être déterminés lors de la création du champ sous l'éditeur.
  • être déterminés par programmation.
  • provenir d'un fichier de données ou d'une requête.
  • provenir d'une variable (globale au projet, à la fenêtre ou à la page, membre de classe, ...).
WINDEV Il est également possible de dessiner dans les champs Liste ou d'afficher une image grâce aux fonctions de manipulation des chaînes graphiques.
Créer un champ Liste
Pour créer un champ Liste :
  1. Sous le volet "Création", dans le groupe "Données" :
    • WINDEV déroulez "Table et liste" et cliquez sur "Liste".
    • WEBDEV - Code Serveur cliquez sur "Liste".
    • WINDEV Mobile déroulez "Liste" et cliquez sur "Liste".
  2. Cliquez dans la fenêtre à la position où le champ doit être créé. L'assistant de création d'un champ Liste se lance automatiquement.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Vocabulaire
Pour manipuler simplement un champ Liste, il est nécessaire de connaître le vocabulaire suivant :
NomDéfinition
Bandeau de sélectionPermet de visualiser l'élément sélectionné. Le plus souvent, une couleur spécifique est utilisée.
Défilement VerticalSens de défilement du champ Liste.
Si le nombre d'éléments affichés dans le champ Liste dépasse le nombre d'éléments visibles, un ascenseur vertical apparaît automatiquement.
Si la taille d'un élément est supérieure à la largeur du champ Liste, cet élément sera tronqué. Aucun ascenseur horizontal n'apparaîtra automatiquement.
Liste FichierLe champ Liste est basé sur un fichier de données ou une requête. Les éléments du champ Liste correspondent à des enregistrements du fichier de données. Deux types de champ Liste fichier sont disponibles :
  • Liste fichier "Chargé en mémoire" : le contenu du champ Liste est chargé en mémoire puis affiché. L'accès aux différents éléments du champ Liste est plus rapide. Ce mode est réservé pour des fichiers de données de moins de 100 000 enregistrements.
  • Liste fichier "Accès direct (sans limite)" : Le champ Liste affiche directement le contenu du fichier de données ou de la requête. L'enregistrement en cours correspond à l'élément sélectionné. Chaque déplacement dans le champ Liste entraîne un accès au fichier de données lié. Ce type de champ Liste est réservé aux fichiers de données de plus de 100 000 enregistrements.
Liste par programmationLe champ Liste n'est basé ni sur un fichier de données ni sur une requête. Les éléments affichés dans le champ Liste sont déterminés par le développeur (dans la fenêtre de description ou par programmation)
Liste monosélectionL'utilisateur peut uniquement sélectionner un élément dans le champ Liste.
Liste multisélectionL'utilisateur peut sélectionner en même temps plusieurs éléments dans le champ Liste.
Pour sélectionner plusieurs éléments, l'utilisateur peut effectuer une des manipulations suivantes :
  • sélectionner les éléments 1 par 1 en maintenant la touche Ctrl enfoncée.
  • sélectionner plusieurs éléments consécutifs en même temps en maintenant la touche Maj enfoncée.
Liste sur variableLe champ Liste est basé sur une variable (globale au projet, à la fenêtre ou à la page, membre de classe, ...).
Notes
WEBDEV - Code Serveur

Champ Liste fichier ou champ Liste sur variable : Nombre de lignes

Il est possible de spécifier le nombre maximum de lignes affichées dans un champ Liste fichier ou sur variable (onglet "Contenu"). Si ce nombre est inférieur au nombre d'éléments du champ Liste, un message d'erreur apparaît au chargement de la page.
Par exemple : Si un champ Liste contient 10 éléments avec un nombre maximum de lignes correspondant à 5, un message d'erreur apparaîtra au chargement de la page.
Remarque : Plus le nombre d'éléments contenus dans le champ est important, plus le temps de chargement de la page sera long.
Java

Limites en Java

En Java, les caractéristiques suivantes ne sont pas gérées :
  • bulle sur ascenseur.
  • champ Liste multicolonne.
  • numéro d'aide associé au champ Liste.
Liste des exemples associés :
Déplacement d'éléments entre deux listes Exemples unitaires (WINDEV) : Déplacement d'éléments entre deux listes
[ + ] Utilisation des fonctions ListeXXX pour déplacer un ou plusieurs éléments d'une liste vers une autre.
Listes graphiques Exemples unitaires (WINDEV) : Listes graphiques
[ + ] Manipulation des listes graphiques :
- Sélectionner ou désélectionner une option de la liste
- Gérer une liste multi-colonnes
- Gérer la sélection par glissement
- Gérer une valeur "cachée"
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Comment ajouter les éléments sélectionnés dans un fichier de données
Je suis sur windev 24 et mon champ liste est lié à un fichier de données mais quand je sélectionne plusieurs lignes du champ liste et que je valide(ecranversfichier), je trouve qu'un seul élément enregistré dans mon fichier de données. et quand j'utilise le champ interrupteur c'est le chiffre 1 que je vois dans le fichier de données. Quelqu'un pour m'aider ?
Galaad
19 oct. 2021
Remplissage par fichier chargé en mémoire: liste incomplète à la fin de l'initialisation
Si à la fin de l'initialisation de la fenêtre on cherche des éléments de la liste, tous ne seront pas présents, même avec un fichier de seulement 16 enregistrements.

ListeSelectPlus(LISTE_1, ListeCherche(LISTE_1, "10") )
ListeCherche() ne trouve pas la ligne

AscenseurPosition(LISTE_1, AscenseurPositionMax(LISTE_1))
Le dernière ligne ne correspond pas au dernier enregistrement

Solution: Changer le remplissage de Chargé en mémoire à Accès Direct
Antonio
13 déc. 2019

Dernière modification : 25/05/2022

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