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
  • Ajout d'un élément sur le navigateur
  • 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,
  • un champ Combo par programmation.
Remarques :
  • Pour ajouter un élément à une position spécifique, utilisez la fonction ListeInsère.
  • La fonction ListeAjoute 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.
WEBDEV - Code Navigateur Attention : L'élément sera ajouté uniquement sur la page affichée dans le navigateur. Pour plus de détails, voir les Remarques.
Exemple
// Ajout de "Dubois" dans le champ "LISTE_ListeClient"
ListeAjoute(LISTE_ListeClient, "Dubois")
WEBDEV - Code ServeurWEBDEV - Code NavigateurAjax
// Ajout de "Dubois" et "Dupont" dans le champ Liste "LISTE_ListeClient"
ListeAjoute(LISTE_ListeClient, "Dubois" + RC + "Dupont")
WEBDEV - Code ServeurWEBDEV - Code NavigateurAjax
// La combo "COMBO_Civilité" affiche les titres de civilité :
// "Monsieur", "Madame" et "Mademoiselle".
// Un entier représentant une civilité sera retourné au langage.
ListeAjoute(COMBO_Civilité, "Monsieur" + gValeurMémorisée("1"))
Syntaxe
ListeAjoute(<Champ à manipuler> [, <Élément>])
<Champ à manipuler> : Nom de champ
Nom du champ à manipuler :
  • Champ Liste par programmation,
  • Champ Liste image par programmation,
  • Champ Combo par programmation.
Si ce paramètre correspond à une chaîne vide (""), l'élément est ajouté dans le champ Liste (ou Combo) auquel appartient l'événement en cours.
WEBDEV - Code Navigateur Le nom du champ Liste (ou Combo) à manipuler doit obligatoirement être spécifié.
<É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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Les caractères Retour Chariot (RC) sont supportés mais les tabulations (TAB) ne sont pas supportées.
WEBDEV - Code Serveur Pour ajouter plusieurs espaces consécutifs, il est nécessaire d'utiliser des espaces insécables : Caract(160).
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).
WEBDEV - Code ServeurAjax

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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurAjax

Équivalence

Les deux syntaxes suivantes sont équivalentes :
ListeAjoute(<Nom du champ>, [<Élément>])
et
<Nom du champ>[Indice] = <Élément>
WEBDEV - Code ServeurWEBDEV - Code NavigateurAjax

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 ListeAjoute doit être préférée à la fonction ListeInsère pour ajouter un élément dans un champ Liste trié.
WEBDEV - Code Navigateur Que le champ Liste soit trié ou non, l'élément est ajouté à la fin du champ.
WEBDEV - Code Navigateur

Ajout d'un élément sur le navigateur

Lors de l'ajout d'un élément en code navigateur, cet élément est ajouté uniquement sur la page affichée dans le navigateur. Pour que cet élément soit également ajouté sur le serveur, il est nécessaire d'exécuter la fonction ListeAjoute sur le serveur.
L'utilisation de la fonction ListeAjoute en code navigateur est intéressante lors de l'utilisation de la technologie AJAX, en mode "AJAX Programmé" (utilisation de la fonction AJAXExécute ou AJAXExécuteAsynchrone).
Rappel : En mode "AJAX automatique et immédiat", il suffit de passer le traitement serveur contenant la fonction ListeAjoute en mode AJAX automatique. Rien de plus ! Aucune programmation supplémentaire n'est nécessaire. Pour plus de détails, consultez AJAX.

Divers

  • Pour ajouter des éléments dans un champ Table, utilisez la fonction TableAjoute.
  • La fonction ListeAjoute 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 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/08/2024

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