DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV 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 <Liste>.Modifie 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"
LISTE_ListeClient.Modifie("Dupond", 4)
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Modification de l'image située Ã  l'indice 4 dans le champ Liste "LSI_Plongée"
LSI_Plongée.Modifie("Belles gorgones", "C:\MesImages\Gorgones.JPG", 4)
Syntaxe
<Champ Liste>.Modifie(<Élément> [, <Image> [, <Indice de l'élément>]])
<Champ Liste> : Nom de champ
<É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 <Liste>.Modifie 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 <Liste>.Occurrence.
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 <Liste>.Modifie 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 <Liste>.Modifie 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" :
    COMBO_MaCombo.Ajoute("MonElément" + gValeurMémorisée("1"))
  • modification de l'élément "MonElément" :
    COMBO_MaCombo.Modifie("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 <Liste>.Modifie sur le serveur.
L'utilisation de la fonction <Liste>.Modifie 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 <Liste>.Modifie 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 <Table>.Modifie.
  • La fonction <Liste>.Modifie peut être utilisée sur une colonne d'un champ Table de type "Combo".
Composante : wd300obj.dll
Voir Aussi
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/06/2023

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