Contrôle de type combobox
Définition
Une combobox fonctionne comme une zone de saisie, mais permet à l'utilisateur d'accéder à une liste de choix possibles, par F4 ou en cliquant sur la flèche à droite.
Ecran de propriétés
Onglet Généralités |
|
|
Variable |
Variable ou champ à afficher dans la zone de saisie de la combobox, et qui servira également au positionnement dans la liste. Si l'utilisateur change cette valeur, le critère débute par sera utilisé pour positionner une valeur alphanumérique, égal à pour positionner une valeur numérique. |
|
Code |
Code qui permet d'agir sur la combobox par programme (pour la cacher ou passer en saisie par exemple) et qui sert pour la production d'événements (Code_CHOIX, Code_SELECTION, etc...). |
|
Titre |
Titre général de la combobox (optionnel). |
|
Message d'aide |
Texte d'aide en une ligne qui apparaîtra dans la ligne d'état si la combobox a le "focus" |
|
Code d'aide |
Code pour l'aide en ligne hypertexte WINDOWS qui servira à choisir la page d'aide à afficher lorsque l'utilisateur en fera la demande (par enfoncement de F1). |
|
Invisible |
Etat initial de la combobox : invisible si coché. |
|
Interdit |
Etat d'autorisation initial de la combobox. Cocher Interdit pour en interdire l'accès. |
|
Titre des colonnes |
Cocher pour que les titres des colonnes s'affichent. |
|
Sans séparateur |
Cocher pour ne pas avoir de séparateurs entre les colonnes. |
|
Limité à la liste |
Choix limité aux éléments de la combobox |
|
L' icône permet
d'avoir accès à tous les champs de la table à laquelle l'écran en cours
est lié.
L'
icône permet d'avoir accès à l'écran de visualisation
des tables décrit dans le chapitre relatif aux utilitaires. Un double
clic sur l'un des champs d'une table renseigne automatiquement la ligne
de la zone de saisie. Une consultation de ces tables peut aider au choix
de la variable.
Onglet Liaison
Table en lien |
Table contenant les champs à afficher dans la combobox. Il peut s'agir de la table principale. |
|
Ordre de tri |
Sélection d'un champ ayant un index séquentiel indexé et pouvant servir à définir un ordre d'affichage dans la combobox. |
|
Code de contexte |
Définition d'un contexte de travail indépendant. L'utilisation des tables contexte permet d'éviter les effets de bord par rapport à l'utilisation de la table par d'autres contrôles. La combobox reste indépendante par rapport à ces autres contrôles. En effet, la définition d'un contexte inclut une position courante, un buffer, un filtre éventuel et un tri éventuel qui lui sont propres. Il est bien sûr possible que plusieurs contrôles travaillent sur le même contexte. |
|
Champ d'origine |
Codes des deux champs servant à établir
la correspondance entre la variable et la combobox. |
|
Filtre |
Filtre de sélection à définir en cliquant sur le bouton associé |
|
La saisie d'un filtre permet de sélectionner un sous-ensemble de la table à afficher dans la combobox et se fait par la fenêtre suivante :
Onglet Colonnes
Descriptif des colonnes |
Ajout d'un élément (colonne) à la combobox. |
|
|
Modification de l'élément ayant le focus. |
|
|
Suppression de l'élément ayant le focus. |
|
|
Déplacement de l'élément ayant le focus vers le haut. En fait, déplacement de la colonne vers la gauche. |
|
|
Déplacement de l'élément ayant le focus vers le bas. En fait, déplacement de la colonne vers la droite. |
La combobox peut contenir des colonnes de différents types. Après avoir cliqué sur le bouton
on choisit le type de colonne par l'écran suivant :
Si une table a été définie dans l'onglet Liaison, une colonne simple sera définie par l'écran suivant qui propose tous les champs de la table :
Il sera en fait possible de définir plusieurs colonnes à la fois en choisissant les différents champs que l'on souhaite faire apparaître dans la liste.
Sinon, la colonne simple sera définie grâce à l'écran suivant :
Cet écran Propriétés de la colonne est accessible pour chaque ligne de la liste Descriptif des colonnes par l'utilisation de la touche Modifier. Il est possible de définir un code pour la colonne.
Grâce à l'utilisation de ce code, le libellé de la colonne sera modifiable par programmation grâce à l'utilisation de la fonction LibelleControle (voir le Manuel de référence).
Ecran de Propriétés d'une combobox à valeurs fixes
On obtient une combobox à valeurs fixes en choisissant la commande correspondante dans le menu déroulant "Elément" :
L'écran de Propriétés est alors :
Onglet Généralités |
|
|
Variable |
Variable ou champ qui recevra le libellé du choix effectué. |
|
Code |
Code qui permet d'agir sur la combobox par programme (pour la cacher ou passer en saisie par exemple) et qui sert pour la production d'événements (Code_CHOIX, Code_SELECTION, etc...). |
|
Lien |
Variable ou champ qui recevra le code du choix effectué. |
|
Titre |
Titre général de la combobox (optionnel). |
|
Message d'aide |
Texte d'aide en une ligne qui apparaîtra dans la ligne d'état si la combobox a le "focus". |
|
Code d'aide |
Code pour l'aide en ligne hypertexte WINDOWS qui servira à choisir la page d'aide à afficher lorsque l'utilisateur en fera la demande (par enfoncement de F1). |
|
Invisible |
Etat initial de la combobox : invisible si coché. |
|
Interdit |
Etat d'autorisation initial de la combobox. Cocher Interdit pour en interdire l'accès. |
|
Limité à la liste |
Choix limité aux éléments de la combobox. Pas de saisie possible. |
|
Pas de début modification |
Si cette option est sélectionnée, la méthode CTRL_DEBUT_MODIF ne sera pas déclenchée lors d'une modification du contenu de la combobox en exécution. Cette méthode se déclenche lors de la première modification sur l'écran. Elle se caractérise par l'apparition d'une étoile dans le bandeau de l'écran... |
|
L'
icône permet
d'avoir accès à tous les champs de la table à laquelle l'écran en cours
est lié.
Onglet Contenu |
Définition des valeurs fixes |
Les valeurs fixes sont entrées sous la forme : valeur à rendre : valeur à afficher. c'est
à dire Dans l'exemple : 1:Monsieur Si l'on n'indique qu'une valeur par ligne, elle joue à la fois le rôle de code et de libellé. |
Il faut utiliser la touche Entrée pour passer à la ligne lors de la saisie de la liste des valeurs.
Avancé :
Il est possible de régler la largeur et le nombre de lignes de la liste affichée en modifiant, dans le fichier .ECR, le paramètre "DimensionList".