PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Liste multisélections
  • É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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Modifie un élément dans un champ Liste mémoire (liste classique ou liste image) ou dans un champ Combo mémoire.
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.
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
// Modification de l'élément situé à l'indice 4 dans la liste "LISTE_ListeClient"
ListeModifie(LISTE_ListeClient, "Dupond", 4)
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU)
// Modification de l'image située à l'indice 4 dans la 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 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 (avec guillemets)
Élément à modifier dans le champ Liste (ou Combo) spécifié.
WINDEVWindows MobileJava 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 (avec guillemets)
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 NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP 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 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 Combo), la fonction ListeModifie n'a aucun effet.
Remarques

Liste multisélections

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/iPadWindows MobileJavaAjaxCode Utilisateur (MCU)

Élément modifié

Lors de la modification d'un élément contenant une valeur invisible (spécifiée grâce à la fonction gLien), il est nécessaire de réutiliser la fonction gLien. 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" + gLien("1"))
  • modification de l'élément "MonElément" :
    ListeModifie(COMBO_MaCombo, "MonNouvelElément" + gLien("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 de table de type "Combo".
Composante : wd240obj.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