Source de données
Insertion automatique
Lorsque cette option est sélectionnée, si un utilisateur saisit une valeur introuvable dans la liste associée à l'objet, cette valeur est automatiquement ajoutée à la liste stockée en mémoire.
Lorsque l'option d'insertion automatique n'est pas définie (par défaut), la valeur saisie est stockée dans l'objet formulaire mais pas dans la liste en mémoire.
Cette propriété est prise en charge par :
- les objets de formulaire Combo box et colonnes de list box associés à une énumération.
- les objets de formulaire Combo box dont la liste associée est remplie par leur tableau ou leur objet datasource.
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 :
Si la liste déroulante a été créée à partir d'une liste définie en mode Développement, la liste d'origine n'est pas modifiée.
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.
Vous pouvez également associer des listes de choix à des objets à l'aide des commandes OBJECT SET LIST BY NAME ou OBJECT SET LIST BY REFERENCE.
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 (Expression type)
Définit le type de données pour l'expression affichée. Cette propriété est utilisée avec :
- les colonnes de list box de type sélection et collection.
- les listes déroulantes associées à des objets ou des tableaux.
Voir aussi la section Expression type.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| dataSourceTypeHint | string |
Objets pris en charge
Listes déroulantes associées à des objets ou à des tableaux - Colonne List Box
Type de données (list)
Définit le type de données à enregistrer dans le champ ou la variable associée à la liste déroulante. Cette propriété est utilisée avec :
- Listes déroulantes associées à une énumération.
- Listes déroulantes associées à une énumération hiérarchique.
Trois options sont disponibles :
- Référence de liste: déclare que la liste déroulante est hiérarchique. Cela signifie que la liste déroulante peut afficher jusqu'à deux niveaux hiérarchiques et que son contenu peut être géré par les commandes du langage 4D du thème Listes hiérarchiques.
- Valeur de l'élément sélectionné (par défaut) : la liste déroulante n'est pas hiérarchique et 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.
- Référence de l'élément sélectionné: la liste déroulante n'est pas hiérarchique et la référence de l'élément de la liste de choix est enregistrée dans l'objet. Cette référence est la valeur numérique associée à chaque élément, soit par l'intermédiaire du paramètre itemRef de la commande
APPEND TO LISTouSET LIST ITEM, soit dans l'éditeur de liste. 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 l'option de Référence élément sélectionné 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). La propriété expression est automatiquement définie.
- Des références valides et uniques doivent être associées aux éléments de la liste.
- La liste déroulante doit être associée à un champ ou à une variable.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| saveAs | string | "value", "reference" |
Définir seulement
"dataSourceTypeHint" : "integer"avec un objet de formulaire"type": "dropdown"déclarera une liste déroulante hiérarchique.
Objets pris en charge
Listes déroulantes associées aux énumérations
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.
Ne pas confondre cette propriété avec la propriété"default value" qui permet de définir la valeur d'un champ dans les nouveaux enregistrements.
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. Par exemple, vous pouvez utiliser This.<propertyPath> où \<propertyPath> est le chemin d'une propriété dans la collection ou un chemin d'attribut d'entité pour accéder à la valeur courante de chaque élément/entité. 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. Dans ce cas, vous utiliserez This.value comme 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. Cette référence est la valeur numérique associée à chaque élément, soit par l'intermédiaire du paramètre itemRef de la commande
APPEND TO LISTouSET LIST ITEM, soit dans l'éditeur de liste.
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). La propriété expression est automatiquement définie.
- Des références valides et uniques doivent être associées aux éléments de la liste.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| saveAs | string | "value", "reference" |
Objets pris en charge
Zone de saisie - Colonne List Box
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 |