DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Liste
  • Champ Liste multisélection
  • Élément modifié
  • 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
Modifie un élément dans un champ Liste par programmation (liste classique ou liste image) ou dans un champ Combo par programmation.
Remarque : La fonction ListeModifie peut être utilisée indifféremment sur les champs Liste monosélection et multisélection.
Exemple
// Modification de l'élément situé à l'indice 4 dans le champ Liste "LISTE_ListeClient"
ListeModifie(LISTE_ListeClient, "Dupond", 4)
WINDEVCode Utilisateur (MCU)
// Modification de l'image située à l'indice 4 dans le champ Liste "LSI_Plongée"
ListeModifie(LSI_Plongée, "Belles gorgones", "C:\MesImages\Gorgones.JPG", 4)
Syntaxe
ListeModifie(<Champ Liste> , <Élément> [, <Image> [, <Indice de l'élément>]])
<Champ Liste> : Nom de champ
Nom du champ à manipuler :
  • Champ Liste,
  • Champ Combo.
Si ce paramètre correspond à une chaîne vide (""), l'élément est modifié dans le champ Liste (ou Combo) auquel appartient l'événement en cours.
<Élément> : Chaîne de caractères
Élément à modifier dans le champ Liste (ou champ Combo) spécifié.
WINDEVJava Dans le cas d'un champ Liste image, ce paramètre correspond au libellé de l'image.
<Image> : Chaîne de caractères optionnelle
Nom et chemin de l'image à ajouter dans un champ Liste image. Ce paramètre est pris en compte uniquement dans le cas d'un champ Liste image affiché 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.
<Indice de l'élément> : Entier optionnel
Indice de l'élément à modifier.
Si ce paramètre :
  • n'est pas précisé ou vaut -1, l'élément en cours est modifié. S'il n'y a pas d'élément en cours, la fonction ListeModifie n'a aucun effet.
  • est égal à 0, le premier élément est modifié.
  • est supérieur au nombre d'éléments présents dans le champ Liste (ou champ Combo), une erreur du WLangage est générée. Le nombre d'éléments présents dans un champ Liste (ou Combo) peut être obtenu avec la fonction ListeOccurrence.
Remarques

Champ Liste multisélection

Si un ou plusieurs éléments sont sélectionnés dans le champ Liste, la fonction ListeModifie ne désélectionne aucun élément.
WINDEVJavaCode Utilisateur (MCU)

Élément modifié

Lors de la modification d'un élément contenant une valeur invisible (spécifiée grâce à la fonction gValeurMémorisée), il est nécessaire de réutiliser la fonction gValeurMémorisée. Dans le cas contraire, cette valeur invisible sera perdue lors de la modification.
Par exemple :
  • ajout de l'élément "MonElément" :
    ListeAjoute(COMBO_MaCombo, "MonElément" + gValeurMémorisée("1"))
  • modification de l'élément "MonElément" :
    ListeModifie(COMBO_MaCombo, "MonNouvelElément" + gValeurMémorisée("1"))

Divers

  • Pour modifier un élément dans un champ Table, utilisez la fonction TableModifie.
  • La fonction ListeModifie peut être utilisée sur une colonne d'un champ Table de type "Combo".
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Il manque une syntaxe?
Il manque la description de la syntaxe à 3 paramètres, sans nom d'image mais avec indice pour une liste qui n'est pas d'images.
Si on essaie la syntaxe, pour une liste qui n'est pas d'images, en mettant un nom d'image vide l'éditeur indique une erreur.
Cette syntaxe apparaît néanmoins dans un des 2 exemples d'en-tête.
Rémi
30 aoû. 2017

Dernière modification : 25/05/2022

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