4D v14.3

OBJET FIXER LISTE PAR NOM

Accueil

 
4D v14.3
OBJET FIXER LISTE PAR NOM

OBJET FIXER LISTE PAR NOM 


 

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

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é.

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

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

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")

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;"")

 
PROPRIÉTÉS 

Produit : 4D
Thème : Objets (Formulaires)
Numéro : 237
Nom intl. : OBJECT SET LIST BY NAME

 
HISTORIQUE 

New
Modifié : 4D v6
Renommé : 4D v12
Modifié : 4D v14
Renommé : 4D v14

 
VOIR AUSSI  

OBJET FIXER LISTE PAR REFERENCE
OBJET Lire nom liste

 
UTILISATION DE L'ARTICLE

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

Hérité de : OBJET FIXER NOM ENUMERATION ( 4D v12.4)