DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Liste
  • Listes supérieures à 10 000 éléments
  • Visibilité/Invisibilité des éléments d'un champ Liste ou d'un champ Combo
  • Équivalence
  • Champ Liste triée/Champ Liste non triée
  • Personnalisation des éléments d'un champ Liste ou d'un champ Combo
  • Tabulations : Champ Liste multi-éléments
  • 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
Ajoute un élément dans :
  • un champ Liste par programmation,
  • WINDEVJava un champ Liste image par programmation,
  • WINDEV un champ Carrousel,
  • un champ Combo par programmation.
Remarques :
  • Pour ajouter un élément à une position spécifique, utilisez la fonction <Liste>.Insère.
  • La fonction <Liste>.Ajoute peut être utilisée indifféremment sur les champs Liste monosélection et multisélection.
  • Pour ajouter une image dans un champ Liste classique, utilisez la fonction gImage.
  • Pour ajouter des éléments dans un champ Combo placé dans une colonne conteneur dans un champ Table, utilisez la propriété Contenu.
Exemple
// Ajout de "Dubois" dans le champ "LISTE_ListeClient"
LISTE_ListeClient.Ajoute("Dubois")
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU) 
// Ajout de "Dubois" et "Dupont" dans le champ Liste "LISTE_ListeClient"
LISTE_ListeClient.Ajoute("Dubois" + RC + "Dupont")
WINDEVJavaCode Utilisateur (MCU) 
// Ajout de l'image "C:\MesImages\Gorgones.JPG" dans le champ Liste image "LSI_PlongéeMer"
// Cette image aura comme libellé "Très belles gorgones"
LSI_PlongéeMer.Ajoute("Très belles gorgones", "C:\MesImages\Gorgones.JPG")
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU) 
// La combo "COMBO_Civilité" affiche les titres de civilité :
// "Monsieur", "Madame" et "Mademoiselle".
// Un entier représentant une civilité sera retourné au langage.
COMBO_Civilité.Ajoute("Monsieur" + gValeurMémorisée("1"))
Syntaxe
<Résultat> = <Champ à manipuler>.Ajoute([<Élément> [, <Chemin de l'image à afficher>]])
<Résultat> : Booléen
  • Vrai si l'élément a été ajouté,
  • Faux dans le cas contraire.
<Champ à manipuler> : Nom de champ
Nom du champ à manipuler.
<Élément> : Chaîne de caractères optionnelle
Élément à ajouter dans le champ spécifié. Si ce paramètre n'est pas spécifié, une ligne vide est ajoutée dans le champ Liste (ou Combo).
Ce paramètre peut contenir :
  • des caractères Retour Chariot (RC) pour ajouter plusieurs éléments.
  • des tabulations (TAB) pour obtenir un champ Liste multi-éléments (voir Notes).
  • la fonction gValeurMémorisée pour indiquer la valeur à renvoyer lors de la sélection de l'élément.
WINDEV Dans le cas d'un champ Carrousel, le contenu de ce paramètre est affiché en survol de l'élément dans le coin haut gauche du champ Carrousel.
WINDEVJava Dans le cas d'un champ Liste image, ce paramètre correspond au libellé de l'image. Ce paramètre peut contenir des caractères Retour Chariot (RC) pour ajouter plusieurs éléments. Dans ce cas :
  • si le paramètre <Chemin de l'image à afficher> n'est pas précisé, les éléments ajoutés seront associés à l'image par défaut (définie dans l'onglet "Détail" de la fenêtre de description du champ).
  • si le paramètre <Chemin de l'image à afficher> est précisé, seul le premier élément sera ajouté. Cet élément sera associé à l'image spécifiée.
Java Les caractères Retour Chariot (RC) sont supportés mais les tabulations (TAB) ne sont pas supportées.
<Chemin de l'image à afficher> : Chaîne de caractères optionnelle
Nom et chemin de l'image à ajouter dans un champ Liste image. Il est également possible d'utiliser une rubrique mémo image ou une variable de type Image.
Ce paramètre est pris en compte uniquement dans le cas d'un champ Liste image, affichée en mode Liste image.
Si ce paramètre n'est pas spécifié, l'image utilisée est l'image par défaut (définie dans l'onglet "Détail" de la fenêtre de description du champ).
Universal Windows 10 App Ce paramètre n'est pas disponible.
Remarques

Listes supérieures à 10 000 éléments

Le nombre maximum d'éléments contenus dans un champ Liste n'est limité que par la mémoire vive disponible (maximum théorique : 2 milliards de lignes). Néanmoins, le fait de remplir un champ Liste avec un très grand nombre d'éléments (plus de 10 000) est pénalisant en termes de performance.
Pour ajouter un grand nombre d'éléments dans un champ Liste, il est conseillé d'utiliser un champ Liste fichier (c'est-à-dire une liste directement reliée à un fichier de données HFSQL).
WINDEVJavaCode Utilisateur (MCU)

Visibilité/Invisibilité des éléments d'un champ Liste ou d'un champ Combo

Pour rendre un élément d'un champ Liste (ou d'un champ Combo) invisible, utilisez la fonction gValeurMémorisée.
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Équivalence

Les deux syntaxes suivantes sont équivalentes :
<Nom du champ>.Ajoute([<Élément>])
et
<Nom du champ>[Indice] = <Élément>
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Champ Liste triée/Champ Liste non triée

  • Si le champ Liste est trié, le nouvel élément est inséré dans l'ordre de tri.
  • Si le champ Liste n'est pas trié, le nouvel élément est ajouté à la fin de la liste.
Le type du champ (trié ou non) est choisi lors de la description du champ (onglet "Détail").

La fonction <Liste>.Ajoute doit être préférée à la fonction <Liste>.Insère pour ajouter un élément dans un champ Liste trié.
WINDEVCode Utilisateur (MCU)

Personnalisation des éléments d'un champ Liste ou d'un champ Combo

Pour personnaliser les éléments présents dans un champ Liste ou dans un champ Combo (couleur de fond, image, dessin, ...), utilisez les Fonctions de gestion des chaînes graphiques.
WINDEVCode Utilisateur (MCU)

Tabulations : Champ Liste multi-éléments

Pour gérer des tabulations dans un champ Liste (alignement de colonnes), utilisez la constante TAB. Par exemple : 
LISTE_Client.Ajoute(Nom + TAB + Prénom)
Dans cet exemple, tous les prénoms commencent à la même position et sont alignés les uns sous les autres.
Remarque : Le premier appel à la fonction <Liste>.Ajoute fixe la position des tabulations. Ces positions serviront de référence pour toutes les valeurs ajoutées par la suite. De même, si des valeurs ont été saisies sous l'éditeur, les positions de ces valeurs sont prises comme référence. Il est donc conseillé, lors du premier appel à la fonction <Liste>.Ajoute, de fixer la largeur des colonnes avec la fonction <Chaîne ANSI>.Complète. Par exemple, pour fixer la largeur des colonnes de "CLIENTS" à 10 caractères : 
LISTE_Client.Ajoute(Complète(Nom, 10) + TAB + Complète(Prénom, 10))

Divers

  • Pour ajouter des éléments dans un champ Table, utilisez la fonction <Table>.Ajoute.
  • La fonction <Liste>.Ajoute peut être utilisée sur :
    • une colonne de type "Combo" dans un champ Table.
    • un champ Combo de type "Table".
Composante : wd300obj.dll
Voir Aussi
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/06/2023

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