PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Champs Liste supérieures à 10 000 éléments
  • Visibilité / Invisibilité des éléments d'un champ Liste ou d'un champ Combo
  • Personnalisation des éléments d'un champ Liste ou d'un champ Combo
  • Champ Liste triée/Liste non triée
  • Tabulations : champ Liste multisélections
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Insère un élément dans un champ Liste mémoire, un champ Liste image mémoire ou un champ Combo mémoire.
Remarques :
  • Pour ajouter un élément à la fin d'un champ Liste (ou Combo), utilisez la fonction ListeAjoute.
  • La fonction ListeInsère peut être utilisée indifféremment sur des champs Liste monosélection et multisélections.
  • Pour gérer le contenu d'un champ Combo placé dans une colonne conteneur de 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
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
// Ajoute le nom "Dubois" à l'indice 4 dans la liste "LISTE_ListeClient"
ListeInsère(LISTE_ListeClient, "Dubois", 4)
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Ajoute l'image "C:\MesImages\Gorgones.JPG" à l'indice 5 dans la liste image "LSI_Plongée"
// Cette image aura comme libellé "Très belles gorgones"
ListeInsère(LSI_Plongée, "Très belles gorgones", "C:\MesImages\Gorgones.JPG", 4)
Syntaxe
<Résultat> = ListeInsère(<Champ Liste> , <Élément> [, <Image> [, <Indice de l'élément>]])
<Résultat> : Booléen
  • Vrai si l'élément a été inséré,
  • Faux dans le cas contraire.
WEBDEV - Code NavigateurPHP La fonction ListeInsère ne retourne pas de résultat.
<Champ Liste> : Nom de champ
Nom du champ Liste mémoire ou Combo mémoire à manipuler.
Si ce paramètre correspond à une chaîne vide (""), l'élément est inséré dans le champ Liste ou Combo auquel le traitement en cours appartient.
WEBDEV - Code Navigateur Le nom du champ Liste ou Combo à manipuler doit obligatoirement être spécifié.
<Élément> : Chaîne de caractères (avec guillemets)
Élément à insérer dans le champ Liste (ou Combo) mémoire spécifiée.
Ce paramètre peut contenir :
  • des caractères Retour Chariot (RC) pour ajouter plusieurs lignes. Dans ce cas :
    • si le paramètre <Indice de l'élément> n'est pas précisé, les éléments sont effectivement ajoutés.
    • si le paramètre <Indice de l'élément> est précisé, seul le premier élément sera ajouté.
  • des tabulations (TAB) pour obtenir une liste multi-éléments (voir Notes).
WINDEVWindows 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 les paramètres <Image> et <Indice de l'élément> ne sont pas précisés, 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 <Image> et le paramètre <Indice de l'élément> sont précisés, seul le premier élément sera ajouté. Cet élément sera associé à l'image par défaut (définie dans l'onglet "Détail" de la fenêtre de description du champ).
  • si le paramètre <Image> est précisé et si le paramètre <Indice de l'élément> n'est pas 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) et les tabulations (TAB) ne sont pas supportés.
WEBDEV - Code Serveur Pour ajouter plusieurs espaces consécutifs, il est nécessaire d'utiliser des espaces insécables : Caract(160).
<Image> : Chaîne de caractères optionnelle (avec guillemets)
Nom et chemin de l'image à ajouter dans une liste 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 NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP Ce paramètre n'est pas disponible.
<Indice de l'élément> : Entier optionnel
Indice de l'élément à insérer.
Si ce paramètre :
  • n'est pas précisé, l'élément est inséré :
    • avant l'élément en cours dans le cas d'un champ Liste monosélection. Si aucun élément n'est en cours, l'élément est inséré à la fin du champ Liste (ou Combo) mémoire.
    • à la fin du champ Liste (ou Combo) mémoire dans le cas d'un champ Liste multisélections.
  • est supérieur au nombre d'éléments présents dans le champ Liste (ou Combo), l'élément est inséré à la fin du champ Liste (ou Combo) mémoire. Le nombre d'éléments présents dans un champ Liste (ou Combo) peut être obtenu avec la fonction ListeOccurrence.
  • est égal à 0, l'élément est ajouté au début du champ Liste (ou Combo) mémoire.
Remarques

Champs Liste supérieures à 10 000 éléments

Le nombre maximum d'éléments pouvant être 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 un champ Liste directement reliée à un fichier de données HFSQL).
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileJavaPHPAjaxCode 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 gLien.
WINDEVEtats et RequêtesWindows MobileCode 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.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)

Champ Liste triée/Liste non triée

  • Si le champ Liste est trié, le nouvel élément est inséré à l'emplacement courant sans trier le champ Liste.
  • Si le champ Liste n'est pas trié, le nouvel élément est ajouté :
    • à l'<Indice de l'élément> si le paramètre <Indice de l'élément> est spécifié.
    • avant l'élément en cours dans le cas d'un champ Liste monosélection si le paramètre <Indice de l'élément> n'est pas spécifié. Si aucun élément n'est en cours, l'élément est inséré à la fin du champ Liste (ou Combo) mémoire.
    • à la fin du champ Liste (ou Combo) mémoire dans le cas d'un champ Liste multisélections si le paramètre <Indice de l'élément> n'est pas spécifié.
Le type du champ Liste (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.
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU)

Tabulations : champ Liste multisélections

Pour gérer des tabulations dans un champ Liste (alignement de colonnes), utilisez la constante TAB. Par exemple :
ListeInsère(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 ListeInsère 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 ListeInsère, de fixer la largeur des colonnes avec la fonction Complète. Par exemple, pour fixer la largeur des colonnes de "LISTE_Client" à 10 caractères :
ListeInsère(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 ListeInsère sur le serveur.
L'utilisation de la fonction ListeInsère 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 ListeInsère en mode AJAX automatique. Rien de plus ! Aucune programmation supplémentaire n'est nécessaire. Pour plus de détails, consultez AJAX.

Divers

  • Pour insérer un élément dans un champ Table, utilisez la fonction TableInsère.
  • La fonction ListeInsère peut être utilisée sur une colonne de type "Combo" dans un champ Table.
Composante : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire