Source de données
Insertion automatique
Lorsque cette option est sélectionnée, si un utilisateur saisit une valeur introuvable dans la liste déroulante associée à l'objet, cette valeur est automatiquement ajoutée à la liste stockée en mémoire. Vous pouvez associer des listes de choix à des objets, à l'aide :
- de la propriété JSON Choice List
- des commandes OBJECT SET LIST BY NAME ou OBJECT SET LIST BY REFERENCE.
- de la liste des propriétés de l'éditeur de formulaires.
Par exemple, pour une liste de choix contenant "France, Allemagne, Italie" associée à une combo box "Pays" : si la propriété d'insertion automatique est définie et qu'un utilisateur saisit "Espagne", la valeur "Espagne" est alors automatiquement ajoutée à la liste en mémoire :
Naturellement, la valeur saisie ne doit pas appartenir à la liste des valeurs exclues associée à l'objet, si elle a été définie.
Si la liste a été créée à partir d'une liste définie en mode Développement, la liste d'origine n'est pas modifiée.
Lorsque l'option d'insertion automatique n'est pas sélectionnée (par défaut), la valeur saisie est stockée dans l'objet mais pas dans la liste en mémoire.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| automaticInsertion | boolean | true, false |
Objets pris en charge
Enumération
Associe une liste de choix à un objet. Il peut s'agir d'un nom de liste de choix (une référence de liste) ou d'une collection de valeurs par défaut.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| choiceList | liste, collection | Une liste de valeurs possibles |
| liste | liste, collection | Une liste de valeurs possibles (listes hiérarchiques uniquement) |
Objets pris en charge
Drop-down List - Combo Box - Hierarchical List - List Box Column
Enumération (liste statique)
Liste de valeurs statiques à utiliser comme étiquettes pour l'objet onglet.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| labels | liste, collection | Une liste de valeurs à saisir dans l'onglet |
Objets pris en charge
Élément courant
Listbox de type collection ou entity selection
Indique une variable ou une expression qui se verra attribuer l'élément/l'entité de collection sélectionné(e) par l'utilisateur. Vous devez utiliser une variable objet ou une expression assignable qui accepte des objets. Si l'utilisateur ne sélectionne rien ou si vous avez utilisé une collection de valeurs scalaires, la valeur Null est affectée.
Cette propriété est en "lecture seule", elle est automatiquement mise à jour en fonction des actions de l'utilisateur dans la list box. Vous ne pouvez pas modifier sa valeur pour modifier l'état de sélection de la list box.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| currentItemSource | string | Expression d'objet |
Objets pris en charge
Position élément courant
Listbox de type collection ou entity selection
Indique une variable ou une expression qui se verra attribuer un entier long indiquant la position de l'élément/l'entité de collection sélectionné(e) par l'utilisateur.
- si aucun(e) élément/entité n'est sélectionné(e), la variable ou l'expression reçoit zéro,
- si un(e) seul(e) élément/entité est sélectionné(e), la variable ou l'expression reçoit son emplacement,
- si plusieurs éléments/entités sont sélectionnés, la variable ou l'expression reçoit la position de l'élément/entité qui a été sélectionné(e) en dernier.
Cette propriété est en "lecture seule", elle est automatiquement mise à jour en fonction des actions de l'utilisateur dans la list box. Vous ne pouvez pas modifier sa valeur pour modifier l'état de sélection de la list box.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| currentItemPositionSource | string | Expression numérique |
Objets pris en charge
Type de données
Veuillez consulter la section Type d'expression.
Objets pris en charge
[Colonne de list box](listbox_overview.md#list-box-columns)
Valeurs par défaut
Liste des valeurs qui seront utilisées comme valeurs par défaut pour la colonne de la list box (type tableau uniquement). Ces valeurs seront automatiquement accessibles dans la variable tableau associée à la colonne lors de l’exécution du formulaire. En utilisant le langage, vous pouvez gérer l'objet en vous référant à ce tableau.
Do not make confusion between this property and the "default value" property that allows to define a field value in new records.
Vous devez saisir une liste de valeurs. Dans l'éditeur de formulaires, une boîte de dialogue spécifique vous permet de saisir des valeurs séparées par des retours à la ligne :
Vous pouvez également définir une énumération avec la colonne de list box. Toutefois, une énumération sera utilisée comme liste de valeurs sélectionnables pour chaque ligne de colonne, alors que la liste par défaut remplit toutes les lignes de colonne.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| values | collection | Une collection de valeurs par défaut (chaînes), ex: "a", "b", "c", "d" |
Objets pris en charge
Colonne de list box (type tableau seulement)
Expression
Cette description est spécifique aux colonnes de list box de type sélection et collection. Voir aussi la section Variable ou expression.
Une expression 4D à associer à une colonne. Vous pouvez saisir :
-
Une variable simple (dans ce cas, elle doit être déclarée explicitement pour la compilation). Vous pouvez utiliser n'importe quel type de variable, à l'exception des BLOB et des tableaux. La valeur de la variable sera généralement calculée dans l'événement
On Display Detail. -
Un champ utilisant la syntaxe standard [Table]Field (list box de type sélection uniquement), par exemple :
[Employees]Name. Les types de champs suivants peuvent être utilisés :- String
- Numérique
- Date
- Time
- Picture
- Booleann
Vous pouvez utiliser des champs de la table principale ou d'autres tables.
-
Une expression 4D (expression simple, formule ou méthode 4D). L'expression doit retourner une valeur. La valeur sera évaluée dans les événements
On Display DetailetOn Data Change. Le résultat de l'expression sera affiché automatiquement lorsque vous passerez en mode Application. L'expression sera évaluée pour chaque enregistrement de la sélection (courante ou nommée) de la table principale (pour les list box de type sélection), chaque élément de la collection (pour les list box de type collection) ou chaque entity de la sélection (pour les list box de type entity selection). Si elle est vide, la colonne n'affichera aucun résultat. Les types d'expression suivants sont pris en charge :- String
- Numérique
- Date
- Picture
- Boolean
Pour les list box de type collection/entity selection, les types Null ou non pris en charge sont affichés sous la forme de chaînes vides.
Lorsque vous utilisez des collections ou des entity selections, vous déclarez généralement la propriété de l'élément ou l'attribut de l'entity associé à une colonne dans une expression contenant This. This est une commande 4D dédiée qui renvoie une référence à l'élément en cours de traitement. For example, you can use **This.\<propertyPath>** where **\<propertyPath>** is the path of a property in the collection or an entity attribute path to access the current value of each element/entity. Si vous utilisez une collection de valeurs scalaires, 4D créera un objet pour chaque élément de la collection avec une seule propriété (nommée "value"), remplie avec la valeur de l'élément. In this case, you will use This.value as expression.
Si une expression non assignable est utilisée (par exemple [Person]FirstName+" "+[Person]LastName), la colonne n'est jamais saisissable, même si la propriété Enterable est activée.
Si un champ, une variable ou une expression assignable*(par exemple Person.lastName*) est utilisé, la colonne peut être saisissable ou non en fonction de la propriété Enterable.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| dataSource | string | Une variable 4D, un nom de champ ou une expression de langage complexe arbitraire. |
Objets pris en charge
[Colonne de list box](listbox_overview.md#list-box-columns)
Table principale
Listbox de type sélection courante
Spécifie la table dont la sélection courante sera utilisée. Cette table et sa sélection courante constitueront la référence pour les champs associés aux colonnes de la list box (références de champs ou expressions contenant des champs). Même si certaines colonnes contiennent des champs d'autres tables, le nombre de lignes affichées sera défini par la table principale.
Toutes les tables de la base de données peuvent être utilisées, que le formulaire soit lié à une table (formulaire table) ou non (formulaire projet).
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| table | number | Numéro de la table |
Objets pris en charge
Enregistrer comme
Cette propriété est disponible dans les conditions suivantes :
- une liste de choix est associée à l'objet
- pour les inputs et les colonnes de list box, une énumération obligatoire est également définie pour l'objet (les deux options doivent généralement utiliser la même liste), de sorte que seules les valeurs de la liste peuvent être saisies par l'utilisateur.
Cette propriété spécifie, dans le contexte d'un champ ou d'une variable associée à une liste de valeurs, le type de contenu à sauvegarder :
- Enregistrer comme valeur (option par défaut) : la valeur de l'élément choisi dans la liste par l'utilisateur est enregistrée directement. Par exemple, si l'utilisateur choisit la valeur "Bleu", cette valeur est enregistrée dans le champ.
- Enregistrer comme référence : la référence de l'élément de l'énumération est enregistrée dans l'objet. This reference is the numeric value associated with each item either through the itemRef parameter of the
APPEND TO LISTorSET LIST ITEMcommands, or in the lists editor.
Cette option permet d'optimiser l'utilisation de la mémoire : le stockage de valeurs numériques dans les champs occupe moins d'espace que le stockage de chaînes de caractères. Il facilite également la traduction des applications : il suffit de créer plusieurs listes dans différentes langues mais avec les mêmes références d'éléments, puis de charger la liste en fonction de la langue de l'application.
L'utilisation de cette propriété nécessite le respect des principes suivants :
- Pour pouvoir stocker la référence, la source de données du champ ou de la variable doit être de type numérique (quel que soit le type de valeur affiché dans la liste).
- Des références valides et uniques doivent être associées aux éléments de la liste.
- If you use this property for a drop-down list, it must be associated with a field.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| saveAs | string | "value", "reference" |
Objets pris en charge
Drop-down List - Input - List Box Column
Eléments sélectionnés
Listbox de type collection ou entity selection
Spécifie une variable ou une expression qui sera assignée aux éléments ou entities sélectionnés par l'utilisateur.
- pour une list box collection, vous devez utiliser une variable de collection ou une expression assignable qui accepte les collections,
- pour une list box de type entity selection, un objet entity selection est construit. Vous devez utiliser une variable objet ou une expression assignable qui accepte des objets.
Cette propriété est en "lecture seule", elle est automatiquement mise à jour en fonction des actions de l'utilisateur dans la list box. Vous ne pouvez pas modifier sa valeur pour modifier l'état de sélection de la list box.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| selectedItemsSource | string | Assignable collection or object expression |
Objets pris en charge
Selection Name
Listbox de type sélection nommée
Spécifie la sélection nommée à utiliser. Vous devez entrer le nom d'une sélection nommée valide. Il peut s'agir d'une sélection nommée process ou interprocess. Le contenu de la list box sera basé sur cette sélection. La sélection nommée doit exister et être valide au moment où la list box est affichée, sinon la list box sera affichée vide.
Les sélections nommées sont des listes ordonnées d'enregistrements. Elles sont utilisées pour garder en mémoire l'ordre et l'enregistrement courant d'une sélection. Pour plus d'informations, reportez-vous à la section Sélections nommées du manuel de référence du langage 4D.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| namedSelection | string | Nom de la sélection |