4D v14.3

TABLEAU VERS LISTE

Accueil

 
4D v14.3
TABLEAU VERS LISTE

TABLEAU VERS LISTE 


 

TABLEAU VERS LISTE ( tableau ; liste {; réfEléments} ) 
Paramètre Type   Description
tableau  Tableau in Tableau duquel copier les éléments
liste  Chaîne, RefListe in Nom ou référence de la liste dans laquelle copier les éléments du tableau
réfEléments  Tableau in Tableau numérique des numéros de référence des éléments

La commande TABLEAU VERS LISTE crée ou remplace la liste hiérarchique ou l'énumération liste en utilisant les éléments du tableau tableau.

Vous pouvez passer dans le paramètre liste soit un nom d'énumération (une chaîne) soit une référence de liste hiérarchique (RefListe). Dans ce deuxième cas, la liste doit déjà avoir été créée (par exemple via la commande Nouvelle liste) pour que la commande fonctionne.

Le paramètre optionnel réfEléments, s'il est passé, doit être un tableau de type numérique synchronisé avec le tableau tableau. Chaque élément de ce tableau indique le numéro de référence de l'élément de la liste correspondant dans tableau. Si ce paramètre est omis, 4D affecte automatiquement aux éléments de la liste les numéros de référence 1, 2... N.

Note de compatibilité : La commande TABLEAU VERS LISTE doit être utilisée avec précaution du fait des limitations suivantes :

  • cette commande permet de définir seulement les éléments du premier niveau de la liste.
  • lorsque vous l'utilisez avec une énumération, cette commande modifie la structure de l'application (les énumérations sont stockées dans le fichier de structure), les modifications effectuées en local seront donc perdues lors de mise à jour du fichier de structure en production.
  • cette commande ne peut pas être utilisée dans un composant avec une énumération car les composants sont chargés avec la structure en lecture seulement.

Vous pouvez utiliser TABLEAU VERS LISTE pour construire une liste basée sur les éléments d'un tableau. Cependant, pour vous affranchir de ces contraintes et exploiter pleinement les listes de valeurs, il est conseillé d'utiliser les commandes du thème Listes hiérarchiques.

Exemple  

L'exemple suivant copie le tableau tabRégions dans l'énumération "Régions" :

 TABLEAU VERS LISTE(tabRégions;"Régions")

Exemple  

Vous souhaitez placer les valeurs distinctes d’un champ dans une liste, par exemple pour créer un pop up menu hiérarchique. Vous pouvez écrire :

 TOUT SELECTIONNER([Company])
 VALEURS DISTINCTES([Company]country;$tabPays)
 listePays:=Nouvelle liste
 TABLEAU VERS LISTE($tabPays;listePays)

La commande TABLEAU VERS LISTE génère l'erreur -9957 lorsqu'elle est appliquée à une énumération en cours de modification en mode Développement. Vous pouvez intercepter cette erreur à l'aide d'une méthode projet de gestion des erreurs installée par la commande APPELER SUR ERREUR.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Tableaux
Numéro : 287
Nom intl. : ARRAY TO LIST

Cette commande modifie la variable système Error

 
HISTORIQUE 

New
Créé : < 4D v6
Modifié : 4D v14

 
VOIR AUSSI  

APPELER SUR ERREUR
Charger liste
LISTE VERS TABLEAU
STOCKER LISTE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Hérité de : TABLEAU VERS ENUMERATION ( 4D v11 SQL Release 6)