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.     
Le premier des deux correspond au champ ou à la variable qui sera affecté en retour en cas de choix de l'utilisateur. Le deuxième correspond au champ sélectionné dans la table en lien

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
            code : libellé

Dans l'exemple :

            1:Monsieur
signifie que l'on affichera Monsieur, et que, si l'utilisateur valide ce choix, lien recevra la valeur 1.

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