Le champ Combo

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Combo

Présentation du champ Combo
Champ d'une fenêtre, champ d'une page dynamique ou statique
Créer un champ Combo
Pour créer un champ de type Combo :
Type de la zone déroulée du champ Combo
Caractéristiques d'un champ Combo
Combo avec saisie : type et masques de la zone de saisie
Ajuster la taille de la zone déroulée
Combo sans saisie : Recherche dans les valeurs du champ Combo
Taille de la zone déroulée
Dessin dans les champs Combo
Limites en Java
Vocabulaire
Permuter

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Le champ Combo

Présentation du champ Combo

Champ d'une fenêtre, champ d'une page dynamique ou statique

Le champ "Combo" permet d'afficher une liste d'éléments et de sélectionner un élément dans cette liste.

A la différence d'un champ Liste, un champ Combo n'est pas déroulé : le champ déroule la liste à la demande ou lors du positionnement du curseur sur la liste.

Sous WINDEV, il est possible de :

saisir directement une valeur dans un champ de saisie, si le champ Combo est avec saisie.
afficher des éléments sous forme de table si le champ Combo contient plusieurs colonnes.
afficher des éléments sous forme de liste image.
ouvrir une fenêtre popup.
redimensionner la largeur et la hauteur de la liste déroulée via le champ Combo (voir ci-dessous)

Quelques exemples :

Champ Combo sans saisie, non déroulé

Combo déroulée avec éléments sous forme de liste

Champ Combo déroulé avec éléments sous forme de liste

Les exemples suivants concernent uniquement WINDEV.

Combo déroulée avec éléments sous forme de table

Champ Combo déroulé avec éléments sous forme de table

Champ Combo avec saisie et saisie assistée

Champ Combo graphique

Combo déroulée avec éléments sous forme de liste image

Champ Combo déroulé avec éléments sous forme de liste image

Champ Combo ouvrant une fenêtre popup

Les éléments apparaissant dans un champ Combo peuvent être déterminés lors de la création du champ sous l'éditeur. Ces éléments :

sont déterminés par programmation.
proviennent d'un fichier de données ou d'une requête.

Créer un champ Combo

Pour créer un champ de type Combo :

Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "Combo".
Cliquez dans la fenêtre / page à la position où le champ doit être créé. L'assistant de création d'un champ Combo se lance automatiquement.

Astuce : Des exemples de champs Combo directement utilisables (avec si nécessaire les données et le code associé) peuvent être intégrés dans vos applications en déroulant l'option "Combo". La liste des champs disponibles apparaît avec pour chacun un aperçu au gabarit du projet et une option "Go" permettant de tester directement le champ proposé. Il suffit de cliquer sur le champ voulu pour le créer dans l'éditeur.

Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.

Pour les applications en mode Windows Store Apps, il est conseillé d'utiliser les combos natives (option "Combo native" dans l'onglet "Détail" de la fenêtre de description du champ).

Type de la zone déroulée du champ Combo

Le type de la zone déroulée du champ Combo dépend des éléments affichés par le champ Combo.

Le type de la zone déroulée du champ Combo peut être changé à tout moment grâce à l'option "Type déroulé" présente dans l'onglet "Contenu" de la fenêtre de description du champ Combo (option "Description" du menu contextuel).

Les types proposés sont les suivants :

Liste : affiche des éléments sous forme de liste.
Dans le cas d'un champ Combo fichier, la rubrique affichée est définie dans l'onglet "Contenu" de la description du champ (option "Description" du menu contextuel).
Table : affiche des éléments sous forme de table. Dès que le champ Combo doit afficher plus d'un élément, une "combo avec table" est automatiquement créée.
Pour afficher les caractéristiques des colonnes de la liste, sélectionnez l'option "Description Colonnes" dans le menu contextuel du champ (ou cliquez sur le bouton "Editer les colonnes" présent dans l'onglet "Contenu" de la description du champ Combo).
Dans le cas d'un champ Combo fichier, les différentes rubriques affichées sont définies dans les caractéristiques des colonnes de la liste (option "Description Colonnes" du menu contextuel ou bouton "Editer les colonnes" dans l'onglet "Contenu" de la description du champ).
Ce type de zone déroulée n'est pas disponible.
En WINDEV Linux, ce type de zone déroulée n'est pas disponible.
Liste image : affiche des éléments sous forme de liste image.
Pour afficher les caractéristiques de la liste image, cliquez sur le bouton "Éditer la Liste image..." présent dans l'onglet "Contenu" de la description du champ Combo.
Dans le cas d'un champ Combo fichier, la rubrique associée au libellé de l'image et celle associée à l'image sont définies grâce aux options "Rubrique affichée" et "Rubrique image" présentes dans l'onglet "Contenu" de la description du champ Combo (option "Description" du menu contextuel).
Ce type de zone déroulée n'est pas disponible.
En WINDEV Linux, ce type de zone déroulée n'est pas disponible.
Fenêtre popup : ouvre une fenêtre popup.
La fenêtre popup à ouvrir peut être sélectionnée dans l'onglet "Contenu" de la description du champ (option "Description" du menu contextuel).
Ce type de zone déroulée n'est pas disponible.

Caractéristiques d'un champ Combo

Combo avec saisie : type et masques de la zone de saisie

Pour les champs Combo avec saisie, il est possible de paramétrer le champ de saisie du champ :

définir le type des données saisies : Texte, Numérique, Monétaire, Date, Heure, Durée.
définir un masque de saisie. Ce masque dépend bien sûr du type d'information (date, texte, ...) affiché dans le champ Combo. Pour chaque type, un grand nombre de masques de saisie est utilisable.
Ces masques de saisie sont multilingues : il est possible de sélectionner des masques de saisies différents selon la langue d'exécution du projet.
Ces masques de saisie peuvent être modifiés en programmation grâce à la propriété MasqueSaisie.
définir un masque d'affichage. Ce masque d'affichage est disponible pour les champs Combo avec saisie de type Numérique, Monétaire, Date, Heure ou Durée.
Ces masques d'affichage sont multilingues : il est possible de sélectionner des masques d'affichage différents selon la langue d'exécution du projet.
Ces masques d'affichage peuvent être modifiés en programmation grâce à la propriété MasqueAffichage.

Pour utiliser des masques multilingues :

Cliquez sur l'icône pour sélectionner des masques multilingues.
Pour chaque langue définie dans votre fenêtre, choisissez le masque approprié.
Validez. Seul le masque de saisie de la langue en cours sous l'éditeur est affiché.

Ajuster la taille de la zone déroulée

La taille de la zone déroulée peut être :

gérée automatiquement par WINDEV. Dans ce cas, elle s'ajuste automatiquement au contenu (par défaut).
définie sous l'éditeur. Dans ce cas, cette taille est fixe.

La taille de la zone déroulée est paramétrée grâce à l'option "Hauteur", disponible dans l'onglet "Détail" de la fenêtre de description du champ. Si cette option vaut 0, la hauteur de la zone déroulée est déterminée automatiquement.

Si la taille de la zone déroulée n'est pas automatique, il est possible d'ajuster la taille de la zone déroulée du champ Combo sous l'éditeur :

Sélectionnez le champ Combo dans la fenêtre.
Cliquez sur le bouton "Spin" du champ Combo. Le curseur de la souris prend l'apparence d'une flèche verticale. La zone déroulée du champ Combo s'affiche sous forme d'un rectangle.
Redimensionnez selon vos besoins la taille de la zone déroulée en manipulant la poignée noire.

Pour modifier la taille de la zone déroulée du champ Combo au pixel près :

Affichez la fenêtre de description du champ Combo (option "Description" du menu contextuel).
Dans l'onglet "Détail", spécifiez la taille (en pixels) de la zone déroulée (options "Hauteur" et "Largeur").

Remarques :

Par défaut, la largeur de la zone déroulée correspond à la largeur de la zone de saisie du champ Combo.
Par défaut, la hauteur de la zone déroulée est optimisée en fonction des éléments affichés dans le champ Combo (option "Hauteur" égale à 0 dans l'onglet "Détail" de la description du champ Combo).
Pour que les utilisateurs finaux puissent également modifier la taille de la zone déroulée directement dans l'application (grâce à la poignée de redimensionnement de la zone déroulée), cochez l'option "Redimensionnable" dans l'onglet "Détail" de la description du champ Combo (option "Description" de menu contextuel).
Pour que la taille de la zone déroulée soit mémorisée lors de la fermeture de la fenêtre par l'utilisateur final, cochez l'option "Mémoriser la taille" dans l'onglet "Détail" de la description du champ Combo (option "Description" de menu contextuel). Ainsi, lors de la ré-ouverture de la fenêtre, la zone déroulée s'affichera selon la taille mémorisée.

Combo sans saisie : Recherche dans les valeurs du champ Combo

Pour les Champs Combo sans saisie listant de nombreuses informations, il est possible de proposer une zone de recherche permettant à l'utilisateur de retrouver facilement l'élément à sélectionner.

Pour mettre en place cette fonctionnalité :

depuis l'éditeur : cochez l'option "Avec recherche" dans l'onglet "Détail" de la fenêtre de description du champ Combo sans saisie.
par programmation : utilisez la propriété RechercheFAA.

Remarque : Le texte d'indication "Recherche" est automatiquement affiché dans la zone de recherche du champ Combo. Ce texte n'est pas paramétrable.

Taille de la zone déroulée

La taille de la zone déroulée dépend du navigateur utilisé. Si le nombre d'éléments du champ Combo est supérieur au nombre d'éléments pouvant être affichés dans la zone déroulée, le défilement est automatiquement géré : la zone déroulée comporte un ascenseur vertical.

Dessin dans les champs Combo

Il est possible de dessiner dans le champs Combo ou d'afficher une image grâce aux fonctions de dessin spécifiques aux champs Liste et Combo.

Remarque : Si une ligne d'un champ Combo affiche une image à l'aide de la fonction gImage, lorsque cette ligne est sélectionnée, l'image est reprise en ligne principale.

Limites en Java

En Java, les caractéristiques suivantes ne sont pas gérées :

bulle sur ascenseur.
saisie obligatoire.
hauteur et largeur de la zone déroulée personnalisées.
numéro d'aide associé au champ Combo.
masque d'affichage de la zone de saisie.
type de la zone de saisie.

Vocabulaire

Pour manipuler simplement un champ Combo, il est nécessaire de connaître le vocabulaire suivant :

Nom	Définition

Bandeau de sélection	Permet de visualiser l'élément sélectionné dans la zone déroulée. Le plus souvent, une couleur spécifique est utilisée.
Combo Fichier	Le champ Combo est basé sur un fichier de données ou une requête. Les éléments du champ correspondent à des enregistrements du fichier de données. Deux types de champ Combo fichier sont disponibles : *Champ Combo fichier "Chargé en mémoire"* : Le contenu du champ est chargé en mémoire puis affiché dans le champ. L'accès aux différents éléments du champ Combo est plus rapide. Ce mode est réservé pour des fichiers de données de moins de 100 000 enregistrements. *Champ Combo fichier "Accès direct (sans limite)"* : Le champ affiche directement le contenu du fichier de données ou de la requête. L'enregistrement en cours correspond à l'élément sélectionné. Chaque déplacement dans le champ entraîne un accès au fichier de données lié. Ce type de champ est réservé aux fichiers de données de plus de 100 000 enregistrements.
Combo par programmation	Le champ Combo n'est basé ni sur un fichier de données ni sur une requête. Les éléments affichés dans le champ Combo sont déterminés par le développeur (dans la fenêtre de description ou par programmation).
Combo avec saisie	L'utilisateur peut saisir du texte dans le champ de saisie associé au champ Combo. Si l'option "Saisie assistée" est sélectionnée, l'utilisateur peut ainsi sélectionner rapidement l'élément en saisissant les premières lettres : les lettres saisies sont automatiquement complétées avec l'élément correspondant.
Combo sans saisie	L'utilisateur sélectionne l'élément dans la zone déroulée à l'aide du bandeau de sélection.

Remarque : "Combo avec saisie" et "Combo sans saisie" ne s'appliquent pas à WEBDEV.

Permuter

WINDEV permet de transformer automatiquement un champ Combo standard en un champ Combo avec table et inversement :

Sélectionnez le champ à transformer.
Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Combo / Combo avec table".

Liste des exemples associés :

Exemples unitaires (WINDEV) : Le champ Combo

[ + ] Utilisation du champ Combo

Exemples complets (WINDEV) : WD Gestion de Parc informatique

[ + ] Cet exemple illustre la gestion d'un parc informatique sous WINDEV.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ les états imprimés, sur requête intégrée notamment,
2/ la représentation graphique de la situation géographique de la machine,
3/ les combos auto-alimentées de type fenêtre popup.
Résumé de l'exemple livré avec WINDEV :
Cet exemple permet de gérer un parc informatique.
Pour chaque machine, on pourra définir ses caractéristiques propres, ses composants, la personne qui l'utilise ainsi que le bureau où la machine est située.

Exemples unitaires (WINDEV) : Le EyeMagnet

[ + ] Utilisation du mécanisme "eYe magnet" (appelé également mise en forme conditionnelle)
Le "eYe magnet" consiste à modifier l'aspect visuel d'un champ afin d'attirer l'attention de l'utilisateur sur ce champ. WINDEV permet de modifier cet aspect visuel automatiquement en fonction d'une série de conditions.

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/10/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale