PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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
  • Hauteur de la zone de saisie du champ Combo
  • Dessin dans les champs Combo
  • Mode smartphone
  • Limites en Java
  • Vocabulaire
  • Permuter
  • Exemple
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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é : elle se déroule à la demande ou lors du positionnement du curseur sur la liste.
Versions 15 et supérieures
Android Les champs Combo sont désormais disponibles pour les applications Android.
Nouveauté 15
Android Les champs Combo sont désormais disponibles pour les applications Android.
Android Les champs Combo sont désormais disponibles pour les applications Android.
Versions 16 et supérieures
WINDEVLinux Les champs Combo sont désormais disponibles pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Les champs Combo sont désormais disponibles pour les applications WINDEV sous Linux.
WINDEVLinux Les champs Combo sont désormais disponibles pour les applications WINDEV sous Linux.
Versions 18 et supérieures
Universal Windows 10 App Les champs Combo sont désormais disponibles pour les applications en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Les champs Combo sont désormais disponibles pour les applications en mode Windows Store apps.
Universal Windows 10 App Les champs Combo sont désormais disponibles pour les applications en mode Windows Store apps.
Versions 19 et supérieures
iPhone/iPad Les champs Combo sont désormais disponibles pour les applications iPhone/iPad.
Nouveauté 19
iPhone/iPad Les champs Combo sont désormais disponibles pour les applications iPhone/iPad.
iPhone/iPad Les champs Combo sont désormais disponibles pour les applications iPhone/iPad.
WINDEVWINDEV Mobile Sous WINDEV et WINDEV Mobile, 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 :
Combo sans saisie, non déroulée
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
WINDEVWINDEV Mobile Les exemples suivants concernent uniquement WINDEV et WINDEV Mobile.
Combo déroulée avec éléments sous forme de table
Champ Combo déroulé avec éléments sous forme de table
Combo avec saisie et saisie assistée
Champ Combo avec saisie et saisie assistée
Combo graphique
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
Combo ouvrant une fenêtre popup
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 :

  1. Sous l'éditeur de fenêtres / pages, cliquez sur l'icône Création d'un champ Combo (ou sélectionnez l'option de menu "Insertion .. Champ .. Combo").Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "Combo".
  2. 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.
WINDEVWINDEV Mobile Astuce : Il est également possible de créer directement un champ Combo "pré-formaté" en cliquant sur la flèche présente à droite de l'icône Flèche. La liste des champs disponibles avec leur aperçu au gabarit du projet apparaît. Il suffit de cliquer sur le champ voulu pour le créer dans l'éditeur.
WINDEVWINDEV Mobile Astuce : Il est également possible de créer directement un champ Combo "pré-formaté" en déroulant l'option "Combo". La liste des champs disponibles avec leur aperçu au gabarit du projet apparaît. 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.
Versions 18 et supérieures
Universal Windows 10 App 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).
Nouveauté 18
Universal Windows 10 App 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).
Universal Windows 10 App 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).
WINDEVAndroidWindows MobileUniversal Windows 10 AppJava

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).
    AndroidiPhone/iPadUniversal Windows 10 App Ce type de zone déroulée n'est pas disponible.
    WINDEVLinux 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 "Editer 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).
    AndroidiPhone/iPadUniversal Windows 10 App Ce type de zone déroulée n'est pas disponible.
    WINDEVLinux 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).
    AndroidiPhone/iPadUniversal Windows 10 App Ce type de zone déroulée n'est pas disponible.
Caractéristiques d'un champ Combo
WINDEVWindows MobileJava

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 :
  • Versions 17 et supérieures
    WINDEVWindows définir le type des données saisies : Texte, Numérique, Monétaire, date, heure, durée.
    Nouveauté 17
    WINDEVWindows définir le type des données saisies : Texte, Numérique, Monétaire, date, heure, durée.
    WINDEVWindows 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.
  • Versions 17 et supérieures
    WINDEVWindows 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.
    Nouveauté 17
    WINDEVWindows 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.
    WINDEVWindows 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 :
  1. Cliquez sur l'icône Multilangue pour sélectionner des masques multilingues.
  2. Pour chaque langue définie dans votre fenêtre, choisissez le masque approprié.
  3. Validez. Le libellé "Valeur multi-langue" apparaît dans la combo de définition des masques.
WINDEVWindows Mobile

Ajuster la taille de la zone déroulée

Pour ajuster la taille de la zone déroulée du champ Combo :
  1. Sélectionnez le champ Combo dans la fenêtre.
  2. 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 en pointillés.
  3. 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 :
  1. Affichez la fenêtre de description du champ Combo (option "Description" du menu contextuel).
  2. 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 de le 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.
Versions 23 et supérieures
WINDEV

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.
Nouveauté 23
WINDEV

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.
WINDEV

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.
WEBDEV - Code Serveur

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.
Windows Mobile

Hauteur de la zone de saisie du champ Combo

Sous l'éditeur, la hauteur de la zone de saisie correspond à la hauteur de la zone de saisie du champ en exécution.
Pour modifier cette hauteur, modifiez la taille de la police dans l'onglet "Style" de la fenêtre de description du champ Combo :
  • du texte de la zone de saisie,
  • de la ligne sélectionnée,
  • des éléments de la combo.
WINDEVWindows Mobile

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.
Windows Mobile

Mode smartphone

Les Smartphones demandent une manipulation particulière en raison de la faible taille de leur écran. Le fonctionnement des champs Combo est particulier sur Smartphone pour cette raison.
Pour plus de détails, consultez Mode smartphone.
Java

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électionPermet de visualiser l'élément sélectionné dans la zone déroulée. Le plus souvent, une couleur spécifique est utilisée.
Combo FichierLe 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 :
  • 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.
  • 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 MémoireLe 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 saisieL'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 saisieL'utilisateur sélectionne l'élément dans la zone déroulée à l'aide du bandeau de sélection.
WEBDEV - Code Serveur Remarque : "Combo avec saisie" et "Combo sans saisie" ne s'appliquent pas à WEBDEV.
Permuter
WINDEVWindows MobileJava WINDEV permet de transformer automatiquement un champ Combo standard en un champ Combo avec table et inversement :
  1. Sélectionnez le champ à transformer.
  2. Sélectionnez l'option "Champ .. Permuter .. Combo / Combo avec table".Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Combo / Combo avec table".
Exemple
Plusieurs champs Combo prédéfinis sont proposés dans le volet "Assistants, Exemples et Composants" :
  1. Cliquez sur le bouton "Champs" du volet "Assistants, Exemples et Composants".
  2. Dans la liste des champs, cliquez sur "Champ pré-rempli".
Pour intégrer un de ces champs dans votre fenêtre ou dans votre page, il suffit d'effectuer un "Drag and Drop" du champ présent dans le volet "Assistants, Exemples et Composants" vers votre fenêtre ou votre page.
Liste des exemples associés :
Le champ Combo Exemples unitaires (WINDEV) : Le champ Combo
[ + ] Utilisation du champ Combo
WD Gestion de Parc informatique 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.
Le EyeMagnet 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.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire