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é
  • Modification 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
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.
WEBDEV - Code Navigateur Attention : L'élément sera modifié uniquement sur la page affichée dans le navigateur. Pour plus de détails, voir les Remarques.
Exemple
// Modification de l'élément situé à l'indice 4 dans le champ Liste "LISTE_ListeClient"
ListeModifie(LISTE_ListeClient, "Dupond", 4)
WINDEVEtats et RequêtesCode 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.
WEBDEV - Code Navigateur Le nom du champ (Liste ou Combo) à manipuler doit obligatoirement être spécifié.
<É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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP 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
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).
WEBDEV - Code ServeurWEBDEV - Code NavigateurUniversal Windows 10 AppAndroidiPhone/iPadPHP 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.
PHP Si ce paramètre est égal à 0 ou est supérieur au nombre d'éléments présents dans le champ Liste (ou champ Combo), la fonction ListeModifie n'a aucun effet.
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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadJavaCode Utilisateur (MCU)Ajax

É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"))
WEBDEV - Code Navigateur

Modification d'un élément sur le navigateur

Lors de la modification d'un élément en code navigateur, cet élément est modifié uniquement sur la page affichée dans le navigateur. Pour que cet élément soit également modifié sur le serveur, il est nécessaire d'exécuter la fonction ListeModifie sur le serveur.
L'utilisation de la fonction ListeModifie 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 ListeModifie en mode AJAX automatique. Rien de plus ! Aucune programmation supplémentaire n'est nécessaire. Pour plus de détails, consultez AJAX.

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 : wd290obj.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