4D Doc Center : OBJET FIXER LISTE PAR NOM

4D v14.3

OBJET FIXER LISTE PAR NOM


OBJET FIXER LISTE PAR NOM ( {* ;} objet {; typeListe}; énumération )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable
objet	Objet de formulaire	Nom d'objet (si * spécifié) ou Champ ou Variable (si * omis)
typeListe	Entier long	Type de liste : Liste énumération, Liste obligations ou Liste exclusions
énumération	Chaîne	Nom de l'énumération (définie en mode Développement) ou "" pour dissocier l’énumération

Description

La commande OBJET FIXER LISTE PAR NOM définit, remplace ou dissocie l'énumération associée à l'objet ou au groupe d'objets désigné(s) par objet. L'énumération dont le nom est passé dans le paramètre énumération doit avoir été créée dans l'éditeur d'énumérations, en mode Développement.

Cette commande peut être appliquée, dans un formulaire entrée ou un formulaire de dialogue, aux champs et variables saisissables dont les valeurs peuvent être saisies sous forme de texte.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d'objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable (champ ou variable objet uniquement).

Note : Cette commande ne peut pas être utilisée avec des champs placés dans le formulaire "liste" d'un sous-formulaire.

La commande OBJET FIXER LISTE PAR NOM vous permet de définir ou de remplacer tous les types d’énumérations associées à l’objet ou aux objets désigné(s) par les paramètres objet et * : listes de choix (énumérations), listes de valeurs obligatoires et listes de valeurs exclues. Pour cela, il vous suffit de passer dans le paramètre typeListe une des constantes suivantes du thème "Objets de formulaire (Propriétés)" :

Constante	Type	Valeur	Commentaire
Liste énumération	Entier long	0	Liste simple de choix de valeurs (option "Enumération" dans la Liste des propriétés) (défaut)
Liste exclusions	Entier long	2	Liste de valeurs non acceptées pour la saisie (option "Exclusions" dans la Liste des propriétés)
Liste obligations	Entier long	1	Liste des seules valeurs acceptées pour la saisie (option "Obligations" dans la Liste des propriétés)

Si vous omettez ce paramètre, la valeur 0 (Liste énumération) est utilisée par défaut.

Pour dissocier dans le process courant une liste associée à l'objet, il suffit de passer une chaîne vide ("") dans le paramètre énumération pour le type de liste concerné.

Exemple 1

L'exemple suivant définit l'énumération liée à un champ Coursiers. Si l'envoi doit être effectué de nuit, alors l'énumération affiche les sociétés de courses qui fonctionnent la nuit. Sinon, l'énumération standard est proposée :

 Si([Courses]Nuit)

    OBJET FIXER LISTE PAR NOM([Courses]Coursier;"Coursiers de nuit")

 Sinon

    OBJET FIXER LISTE PAR NOM([Courses]Coursier;"Coursiers standard")

 Fin de si

Exemple 2

Associer la liste "choix_coul" en tant qu’énumération simple au pop up/Liste déroulante "CoulPorte" :

 OBJET FIXER LISTE PAR NOM(*;"CoulPorte";Liste énumération;"choix_coul")

     // dans ce cas le 3e paramètre (constante) peut être omis

Exemple 3

Vous souhaitez associer la liste "choix_coul" à une combo box "CoulMur". Comme la combo box est saisissable, vous souhaitez que certaines couleurs telles que "noir", "violet"... ne puissent être utilisées. Ces couleurs sont placées dans la liste "coul_exclues" :

 OBJET FIXER LISTE PAR NOM(*;"CoulMur";Liste énumération;"choix_coul")

 OBJET FIXER LISTE PAR NOM(*;"CoulMur";Liste exclusions;"coul_exclues")

Exemple 4

Vous souhaitez supprimer des associations de listes :

     // retrait de l’énumération simple

 OBJET FIXER LISTE PAR NOM(*;"CoulPorte";Liste énumération;"")

     // retrait de la liste de valeurs non autorisées

 OBJET FIXER LISTE PAR NOM(*;"CoulMur";Liste exclusions;"")