Aller au contenu principal
Version: 20

Combo Box

Une combo box est semblable à une liste déroulante, hormis le fait que cet objet accepte la saisie de texte par l’utilisateur et qu'elle dispose d'options supplémentaires.

Fondamentalement, vous devez considérer l’objet combo box comme une zone saisissable qui utilise un tableau ou une liste de choix en tant que liste de valeurs par défaut.

Gestion des combo boxes

Utilisez l’événement formulaire On Data Change pour gérer les valeurs saisies, comme pour toute zone de saisie.

L'initialisation d'une combo box se fait exactement de la même manière que celle d'une liste déroulante : en utilisant un objet, un tableau ou une liste de choix.

Utilisation d'un objet

Cette fonctionnalité n'est disponible que dans les projets 4D.

Un objet encapsulant une collection peut être utilisé comme source de données d'une combo box. Cet objet doit avoir les propriétés suivantes :

PropriétéTypeDescription
valuesCollectionObligatoire - Collection de valeurs scalaires. Toutes les valeurs doivent être du même type. Types pris en charge :
  • chaînes
  • nombres
  • dates
  • heures
  • Si elle est vide ou non définie, la combo box est vide
    currentValueidentique à CollectionTexte saisi par l'utilisateur

    Si l'objet contient d'autres propriétés, elles sont ignorées.

    Lorsque l'utilisateur saisit du texte dans la combo box, la propriété currentValue de l'objet reçoit le texte saisi.

    Utiliser un tableau

    Veuillez vous référer à Utiliser un tableau dans la page liste déroulante pour obtenir des informations sur l'initialisation du tableau.

    Lorsque l'utilisateur saisit du texte dans la combo box, l'élément 0 du tableau reçoit le texte saisi.

    Utiliser une énumération

    Si vous souhaitez utiliser une combo box pour gérer les valeurs d'une zone de saisie (champ ou variable énuméré(e)), 4D vous permet de référencer directement le champ ou la variable en tant que source de données de l'objet formulaire. Cette possibilité facilite la gestion des champs/variables énuméré(e) s.

    Si vous utilisez une énumération hiérarchique, seul le premier niveau sera affiché et sélectionnable.

    Pour associer une combo box à un champ ou à une variable, il suffit de saisir le nom du champ ou de la variable directement dans le champ Variable ou Expression de l'objet formulaire dans la liste des propriétés.

    Lorsque le formulaire est exécuté, 4D gère automatiquement la combo box lors de la saisie ou de l'affichage : lorsque l'utilisateur choisit une valeur, celle-ci est enregistrée dans le champ ; cette valeur de champ est affichée dans la combo box lors de l'affichage du formulaire :

    Pour plus d'informations, veuillez consulter Utiliser une énumération dans la page liste déroulante.

    Options

    Les objets de type combo box acceptent deux options spécifiques :

    • Insertion automatique : permet d'ajouter automatiquement une valeur à la source de données lorsque l'utilisateur saisit une valeur qui ne se trouve pas dans la liste associée à la combo box.
    • Exclusion (liste de valeurs exclues) : permet d'établir une liste dont les valeurs ne peuvent pas être saisies dans la combo box. Si une valeur exclue est saisie, elle n'est pas acceptée et un message d'erreur s'affiche.

    La possibilité d’associer une liste de valeurs obligatoires n’est pas disponible pour les combo box. Dans une interface, si un objet doit proposer une liste finie de valeurs obligatoires, il faut utiliser un objet de type liste déroulante.

    Propriétés prises en charge

    Format Alpha - Gras - Bas - Liste de choix - Classe - Format de date - Type d'expression - Police - Couleur de police - Taille de police - Hauteur - Conseil d'aide - Dimensionnement horizontal - Italique - Gauche - Nom d'objet - Droite - Format de l'heure - Haut - Type - Souligné - Variable ou expression - Dimensionnement vertical - Visibilité - Largeur