PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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 WatchCatalystUniversal 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 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Exemple
// Modification de l'élément situé à l'indice 4 dans le champ Liste "LISTE_ListeClient"
ListeModifie(LISTE_ListeClient, "Dupond", 4)
Syntaxe
ListeModifie(<Champ Liste> , <Élément> [, <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 (avec guillemets)
Élément à modifier dans le champ Liste (ou champ Combo) spécifié.
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).
<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.
WEBDEV - Code ServeurAjax

É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 d'un champ Table de type "Combo".
Composante : wd250obj.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