PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Listes supérieures à 10 000 éléments
  • Visibilité/Invisibilité des éléments d'un champ Liste ou Combo
  • Équivalence
  • Champ Liste triée/Champ Liste non triée
  • Personnalisation des éléments d'un champ Liste ou Combo
  • Tabulations : Champ Liste multi-éléments
  • Ajout d'un élément sur le navigateur
  • Divers
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Ajoute un élément dans :
  • un champ Liste mémoire,
  • WINDEVWINDEV MobileWindows MobileJava un champ Liste image mémoire,
  • WINDEV un champ Carrousel,
  • un champ Combo mémoire.
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 mono-sélection et multi-sélections.
  • 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 Notes.
Versions 15 et supérieures
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileAndroid 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
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Ajout de "Dubois" dans le champ "LISTE_ListeClient"
ListeAjoute(LISTE_ListeClient, "Dubois")
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidJavaAjaxCode Utilisateur (MCU)
// Ajout de "Dubois" et "Dupont" dans le champ Liste "LISTE_ListeClient"
ListeAjoute(LISTE_ListeClient, "Dubois" + RC + "Dupont")
WINDEVWINDEV MobileEtats et RequêtesWindows MobileJavaCode 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"
ListeAjoute(LSI_PlongéeMer, "Très belles gorgones", "C:\MesImages\Gorgones.JPG")
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidJavaAjaxCode 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.
ListeAjoute(COMBO_Civilité, "Monsieur" + gLien("1"))
Syntaxe
<Résultat> = ListeAjoute(<Nom du champ> [, <Élément> [, <Chemin de l'image à afficher>]])
<Résultat> : Booléen
  • Vrai si l'élément a été ajouté,
  • Faux dans le cas contraire.
WEBDEV - Code NavigateurPHP La fonction ListeAjoute ne retourne pas de résultat.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ Liste (liste, liste image, ou combo) mémoire à manipuler.

Si ce paramètre correspond à une chaîne vide (""), l'élément est ajouté dans le champ Liste (ou Combo) à laquelle appartient le traitement 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 (avec guillemets)
É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 une liste multi-éléments (voir Notes).
  • la fonction gLien 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.
WINDEVWINDEV MobileWindows MobileJava 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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidJavaPHP 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).
<Chemin de l'image à afficher> : Chaîne de caractères optionnelle (avec guillemets)
Nom et chemin de l'image à ajouter dans un champ Liste image. Il est également possible d'utiliser une rubrique mémo 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).
WEBDEV - Code ServeurWEBDEV - Code NavigateurUniversal Windows 10 AppAndroidiPhone/iPadPHP 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 terme 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).
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

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

Pour rendre un élément d'un champ Liste ou Combo invisible, utilisez la fonction gLien.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode Utilisateur (MCU)

Équivalence

Les deux syntaxes suivantes sont équivalentes :
ListeAjoute(<Nom de la liste> [<Élément>])
et
<Nom de la liste>[Indice] = <Élément>
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppAndroidiPhone/iPadJavaAjaxCode 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 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.
WINDEVWINDEV MobileEtats et RequêtesWindows MobileCode Utilisateur (MCU)

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

Pour personnaliser les éléments présents dans un champ Liste ou Combo (couleur de fond, image, dessin, ...), utilisez les Fonctions de dessin dans les champs Liste et Combos.
WINDEVWINDEV MobileEtats et RequêtesWindows MobileCode 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 :
ListeAjoute(LISTE_Client, 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 ListeAjoute 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 ListeAjoute, de fixer la largeur des colonnes avec la fonction Complète. Par exemple, pour fixer la largeur des colonnes de "CLIENTS" à 10 caractères :
ListeAjoute(LISTE_Client, Complète(Nom, 10) + TAB + Complète(Prénom, 10))
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.
    • une combo de type "Table".
Composantes
WINDEVEtats et Requêtes wd220obj.dll
WEBDEV - Code Serveur wd220page.dll
Windows Mobile wp220obj.dll
WEBDEV - Code Navigateur WDJS.DLL
Java wd220java.jar
Linux wd220obj.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
ListBox como Ajuda

//Selecting a row of list_Ajuda

IF IsNumeric(LIST_ajuda..StoredValue[[1 TO 2]]) THEN
EDT_Tpag_nfe=LIST_ajuda..StoredValue[[1 TO 2]]
END
ReturnToCapture(EDT_Tpag_nfe)


//Blog com Video e exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/04/curso-windev-listbox-002-criar-listbox.html

De matos AMARILDO
09 avr. 2016