OBJECT SET LIST BY NAME
OBJECT SET LIST BY NAME ( {* ;} 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 | any | → | Nom d'objet (si * spécifié) ou Champ ou Variable (si * omis) |
| typeListe | Integer | → | Type de liste : Liste énumération, Liste obligations ou Liste exclusions |
| énumération | Text | → | Nom de l'énumération (définie en mode Développement) ou "" pour dissocier l’énumération |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande OBJECT SET LIST BY NAME 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 OBJECT SET LIST BY NAME 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 | Comment |
|---|---|---|---|
| Choice list | Entier long | 0 | Liste simple de choix de valeurs (option "Enumération" dans la Liste des propriétés) (défaut) |
| Excluded list | Entier long | 2 | Liste de valeurs non acceptées pour la saisie (option "Exclusions" dans la Liste des propriétés) |
| Required list | 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é.
La liste de valeurs existante est remplacée en fonction de la manière dont la liste est associée à l'objet de formulaire :
- à l'aide d'une énumération : la liste elle-même est remplacée.
- à l'aide d'un tableau : la liste est copiée dans les éléments du tableau.
- à l'aide d'un objet (non pris en charge dans les bases binaires) : la liste est copiée en tant qu'éléments de collection dans la propriété values de l'objet.
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 :
If([Courses]Nuit)
OBJECT SET LIST BY NAME([Courses]Coursier;"Coursiers de nuit")
Else
OBJECT SET LIST BY NAME([Courses]Coursier;"Coursiers standard")
End if
Exemple 2
Associer la liste "choix_coul" en tant qu’énumération simple au pop up/Liste déroulante "CoulPorte" :
OBJECT SET LIST BY NAME(*;"CoulPorte";Choice list;"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" :
OBJECT SET LIST BY NAME(*;"CoulMur";Choice list;"choix_coul")
OBJECT SET LIST BY NAME(*;"CoulMur";Excluded list;"coul_exclues")
Exemple 4
Vous souhaitez supprimer des associations de listes :
// retrait de l’énumération simple
OBJECT SET LIST BY NAME(*;"CoulPorte";Choice list;"")
// retrait de la liste de valeurs non autorisées
OBJECT SET LIST BY NAME(*;"CoulMur";Excluded list;"")