DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Table
  • Présentation
  • Créer une colonne de type Combo
  • Caractéristiques des colonnes de type Combo
  • Limites en Java
  • Programmation d'une colonne de type Combo
  • Initialisation du contenu de la colonne de type Combo
  • Sélection d'un élément de la colonne de type Combo par programmation
  • Récupération du contenu d'une colonne de type Combo
  • Combo avec ou sans saisie
  • Remarque
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Colonnes de type Combo dans les champs Table (syntaxe préfixée)
Présentation
Un champ Table (par programmation, fichier ou sur variable) peut comporter des colonnes de type Combo.
Les colonnes de type Combo peuvent être utilisées par exemple pour visualiser dans un champ Table les rubriques d'un fichier de données de type "Combo, Liste, Sélecteur ou Interrupteur". Les colonnes de type Combo permettent également d'afficher des images dans un champ Table.
Rappel : Pour afficher une image dans un champ Table, utilisez une colonne de type Image.
Pour plus de détails sur les champs Combo, consultez Champ Combo.
Créer une colonne de type Combo
Pour créer une colonne de type Combo, il suffit de sélectionner l'option "Combo" dans le type de la colonne :
Caractéristiques des colonnes de type Combo
D'une manière générale, une colonne de type Combo dans un champ Table a toutes les caractéristiques d'un champ Combo. Cette colonne de type Combo peut être par exemple liée à un fichier de données.
Plus particulièrement, les caractéristiques suivantes sont disponibles :
  • Combo avec ou sans saisie (onglet "Détail" de la description de la colonne).
  • Combo avec ou sans saisie assistée (onglet "Détail" de la description de la colonne).
  • Combo triée ou non (cas des champs Combo par programmation uniquement, onglet "Détail" de la description de la colonne).
  • Paramétrage du bouton associé à la combo de la colonne (onglet "Détail" de la description de la colonne).
  • Paramétrage de la liste déroulée : largeur, hauteur, liste redimensionnable (onglet "Détail" de la description de la colonne).
  • Affichage ou non du bandeau de sélection dans la combo de la colonne (onglet "UI" de la description de la colonne).
  • Paramétrage du style de la combo de la colonne (onglet "Style", élément "Colonne combo (bouton)").
Si la colonne de type Combo n'est pas liée à une rubrique de fichier de données, il est possible de saisir le contenu initial de la colonne.
Remarque : La hauteur d'une ligne de la colonne de type Combo est celle de la hauteur d'une ligne du champ Table.
Java

Limites en Java

En Java, les caractéristiques suivantes ne sont pas gérées :
  • Le spin de la colonne de type Combo est visible uniquement sur la ligne en cours.
  • La hauteur et la largeur déroulée personnalisée.
Programmation d'une colonne de type Combo

Initialisation du contenu de la colonne de type Combo

Le contenu de la colonne de type Combo peut être initialisé :
  • sous l'éditeur, dans le détail de la colonne : il ne peut alors pas être graphique.
  • par programmation avec la fonction <Liste>.Ajoute, par exemple dans l'événement "Initialisation" du champ Table.
Le contenu de la colonne de type Combo ne pourra pas être modifié, même si le champ Combo est en saisie. Ainsi, les valeurs proposées dans une colonne de type Combo seront les mêmes pour toutes les lignes du champ Table.

Sélection d'un élément de la colonne de type Combo par programmation

Pour sélectionner un élément de la colonne de type Combo, il suffit de spécifier l'indice de l'élément de la combo à afficher. Cet indice peut être utilisé avec les fonctions de gestion des champs Table.
Par exemple :
  • ajout d'une ligne avec la fonction <Table>.Ajoute :
    // TABLE_TableClient contient :
    // - une colonne de type Combo affichant la civilité des clients
    // (1 correspond Ã  "Mr", 2 Ã  "Mme" et 3 Ã  "Melle")
    // - une colonne de type chaîne affichant le nom des clients
    // Ajout de "Mr" et "Dubois" Ã  la fin de ce champ Table
    TABLE_TableClient.Ajoute(1 + TAB + "Dubois")
  • modification de la 5° ligne avec la fonction <Table>.ModifieLigne :
    // TABLE_TableClient contient :
    // - une colonne de type Combo affichant la civilité des clients
    // (1 correspond Ã  "Mr", 2 Ã  "Mme" et 3 Ã  "Melle")
    // - une colonne de type chaîne affichant le nom des clients
    // Modification de la 5° ligne avec "Mme" et "Thomas"
    TABLE_TableClient.ModifieLigne(5, 2, "Thomas")

Récupération du contenu d'une colonne de type Combo

La valeur sélectionnée dans une colonne de type Combo peut être récupérée avec la propriété Valeur.

Combo avec ou sans saisie

  • Important :
    • Dans une colonne de type Combo sans saisie, il n'est pas possible de récupérer directement le contenu d'une combo : seul l'indice peut être connu. Pour connaître la valeur sélectionnée dans la colonne de type Combo, utilisez la propriété ValeurAffichée.
    • Dans une colonne de type Combo avec saisie, le contenu de la combo peut être récupéré directement.
  • La colonne de type combo mémorise l'indice correspondant de la combo (si une rubrique est associée à la colonne, la rubrique mémorise l'indice également). Il est donc fondamental que le contenu du champ Combo ne soit pas modifié.
  • Les événements associés à une colonne de type Combo sont identiques à ceux d'un champ Combo.
  • Les colonnes de type Combo sans saisie et "en affichage seulement" ne se déroulent pas.

Remarque

Les champs Combo dans les champs Table ont le même contenu pour toutes les lignes : seule la valeur sélectionnée change en fonction de la ligne. Il est toutefois possible depuis la version 14 de changer le contenu des colonnes de type Combo pour chaque ligne. Il faut pour cela utiliser la propriété Contenu de la colonne de type Combo.
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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