Contrôle qui permet aux utilisateurs d’effectuer des sélections parmi les options fournies. Prend en charge la recherche et la sélection multiple.

Description

Un contrôle Combo Box (zone de liste modifiable) vous permet de rechercher des éléments que vous sélectionnez. La recherche est effectuée côté serveur sur la propriété SearchField. Ainsi, les performances ne sont pas affectées par les sources de données très volumineuses.

Le mode de sélection simple ou multiple est configuré via la propriété SelectMultiple.

Pour rechercher des éléments à sélectionner, pour chaque élément, vous pouvez choisir d’afficher une seule valeur de données, deux valeurs ou une image et deux valeurs (personne) en modifiant le paramètre de disposition dans le volet Données.

Principales propriétés

Items : source de données à partir de laquelle des sélections peuvent être effectuées.

DefaultItems : éléments sélectionnés avant que l’utilisateur interagisse avec le contrôle.

SelectedItems : liste des éléments sélectionnés résultant de l’interaction de l’utilisateur.

SelectMultiple : indique si l’utilisateur peut sélectionner un ou plusieurs éléments.

IsSearchable : indique si l’utilisateur peut rechercher des éléments avant d’effectuer une sélection.

Propriétés supplémentaires

BorderColor : couleur de bordure du contrôle.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness : épaisseur de bordure d’un contrôle.

Default : sélection initiale avant sa modification par l’utilisateur dans le mode de sélection unique.

DisplayFields : liste des champs affichés pour chaque élément retourné par la recherche. Le plus simple est de configurer via le volet Données dans l’onglet d’options des propriétés.

DisplayMode : indique si le contrôle autorise l’entrée d’un utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

Height : distance entre le haut et le bas d’un contrôle.

InputTextPlaceholder : texte d’instruction affiché aux utilisateurs finaux quand aucun élément n’est sélectionné.

OnChange : comment l’application répond quand l’utilisateur change une sélection.

OnNavigate : comment l’application répond quand l’utilisateur clique sur un élément.

OnSelect : comment l’application répond quand l’utilisateur appuie ou clique sur un contrôle.

Visible : indique si un contrôle est visible ou est masqué.

Width : distance entre les côtés droit et gauche d’un contrôle.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).

Exemple

  1. Ajoutez un contrôle Combo Box (zone de liste modifiable) à partir de l’onglet Insérer, dans le menu Contrôles.
  2. Dans l’onglet d’options des propriétés, cliquez sur Données.
  3. Sélectionnez la source de données, la disposition et les propriétés associées ci-dessous.
  4. Définissez la propriété SelectMultiple sous l’onglet Avancé.

    Une zone de liste modifiable fonctionnelle s’affiche dans votre application.

    Vous ne savez pas comment ajouter et configurer un contrôle ?