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 Combo
  • Présentation
  • Initialiser et remplir un champ Combo
  • Initialiser un élément
  • Remplir un champ Combo
  • Sélectionner un élément dans un champ Combo
  • Sélectionner un élément dans un champ Combo
  • Sélectionner le dernier élément d'un champ Combo
  • Récupérer l'élément sélectionné dans le champ Combo
  • Récupérer l'indice de l'élément sélectionné
  • Récupérer la valeur de l'élément sélectionné
  • Chercher un élément dans un champ Combo avec table
  • Propriétés spécifiques à la gestion des champs Combo
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
Présentation
WINDEV, WINDEV Mobile et WEBDEV permettent de manipuler un champ Combo directement par programmation. Il suffit d'utiliser directement la variable du champ Combo dans le code. Cette variable est de type numérique.
La variable du champ Combo :
  • correspond au nom du champ Combo.
  • est initialisée avec l'indice de l'élément sélectionné dans le champ.
Pour manipuler un élément du champ Combo, il suffit d'utiliser la notation suivante :
<Champ Combo>[<Indice de l'élément>]
Remarque : De nombreuses fonctions du WLangage sont spécifiques à la gestion des champs de type Combo. Pour plus de détails, consultez : les fonctions de gestion des champs Liste et Combo et fonctions spécifiques à la gestion des champs Combo.
Initialiser et remplir un champ Combo

Initialiser un élément

Pour initialiser un élément d'un champ Combo avec ou sans saisie, utilisez la fonction ListeAjoute.
Pour modifier un élément d'un champ Combo avec ou sans saisie, vous pouvez utiliser l'affectation directe :
<Champ Combo>[Indice] = <Valeur>
Android Sous Android, il n'est pas possible d'affecter une valeur négative ou nulle à un champ Combo. Si le champ Combo n'est pas vide, il doit nécessairement avoir un élément sélectionné. Une erreur sera affichée si une valeur négative ou nulle est affectée à un champ Combo.

Remplir un champ Combo

Pour initialiser un champ Combo, il suffit d'utiliser une boucle d'itération pour initialiser tous les éléments du champ.
Indice est un entier
POUR Indice = <Position Début> A <Position Fin>
ListeAjoute(<Champ Combo>, <Valeur>)
FIN
Exemple :
i est un entier
POUR i = 1 Ã€ 52
ListeAjoute(COMBO_COMBO, NOM[i]) 
FIN
Sélectionner un élément dans un champ Combo

Sélectionner un élément dans un champ Combo

Pour sélectionner l'élément de la ligne <Indice>, utilisez :
  • soit l'affectation directe :
    <Champ Combo> = Indice
  • soit la fonction ListeSelectPlus :
    ListeSelectPlus(<Champ Combo>, <Indice>)
Remarque : Si le champ Combo est initialisé avec la fonction gValeurMémorisée, il est nécessaire d'utiliser la valeur de la fonction gValeurMémorisée pour sélectionner un élément.
Par exemple, si le champ Combo est initialisé avec le code :
ListeAjoute(COMBO_Personne, "Mon texte" + gValeurMémorisée(ValeurMémorisée))
le code suivant permettra de sélectionner un élément :
COMBO_Personne = ValeurMémorisée

Sélectionner le dernier élément d'un champ Combo

Pour se positionner sur le dernier élément du champ Combo, utilisez :
  • soit la propriété Occurrence :
    <Champ Combo> = <Champ Combo>.Occurrence
  • soit la fonction ListeSelectPlus associée à la propriété Occurrence :
    ListeSelectPlus(<Champ Combo>, <Champ Combo>.Occurrence)
  • soit la fonction ListeOccurrence :
    <Champ Combo> = ListeOccurrence(<Champ Combo>)
Récupérer l'élément sélectionné dans le champ Combo

Récupérer l'indice de l'élément sélectionné

Pour récupérer l'indice de l'élément sélectionné, utilisez :
  • soit la lecture directe de l'élément :
    Indice = <Champ Combo>
  • soit la fonction ListeSelect :
    Indice = ListeSelect(<Champ Combo>)

Récupérer la valeur de l'élément sélectionné

Pour récupérer la valeur de l'élément sélectionné, utilisez une des syntaxes suivantes :
  • Syntaxe 1 : Champ Combo sans saisie
    indice est un entier = <Champ Combo>
    <Variable> = <Champ Combo>[indice]
  • Syntaxe 2 : Champ Combo sans saisie
    <Variable> = <Champ Combo>[<Champ Combo>]
  • Syntaxe 3 : Champ Combo avec ou sans saisie : Propriété ValeurAffichée

    <Variable> = <Champ Combo>.ValeurAffichée
Chercher un élément dans un champ Combo avec table
Propriétés spécifiques à la gestion des champs Combo
Les propriétés suivantes sont spécifiques à la gestion des champs Combo :
Tout type de combo
CadrageHorizontalPermet de connaître et de modifier le cadrage horizontal des éléments du champ Combo.
EllipsePermet de connaître et modifier le mode de gestion de l'ellipse.
HauteurLignePermet de connaître et de modifier la hauteur des lignes d'un champ Combo.
MémoirePermet de savoir si le champ spécifié est un champ Combo par programmation ou un champ Combo fichier.
OccurrencePermet de connaître le nombre de lignes présentes dans un champ Combo.
TypeRemplissagePermet de connaître le type de remplissage (fichier, par programmation, sur variable) d'un champ Combo.
VidePermet de savoir si un champ Combo est vide.
Champ Combo avec saisie uniquement
AvecSaisiePermet de connaître et de modifier le mode de saisie du champ Combo (combo avec ou sans saisie).
CurseurPermet de connaître et de modifier la position du curseur de la souris dans un champ.
FinCurseurPermet de connaître et de modifier la position de fin de sélection du curseur de la souris.
FormatMémoriséPermet de connaître et de modifier le format de la valeur retournée.
MasqueAffichagePermet de connaître et de modifier le masque d'affichage.
MasqueSaisiePermet de connaître et de modifier le masque de saisie.
TaillePermet de connaître et de modifier le nombre maximum de caractères contenus dans le champ de saisie de la combo.
TexteSélectionnéPermet de connaître et de modifier le texte sélectionné dans le champ de saisie de la combo.
TypeSaisiePermet de connaître et de modifier le type de données saisies dans le champ de saisie de la combo.
Champ Combo sans saisie uniquement
RechercheFAAPermet de :
  • savoir si la recherche est active sur un champ Combo sans saisie,
  • activer ou non la recherche via la FAA sur un champ Combo sans saisie.
Champ Combo par programmation uniquement
ContenuInitialPermet de connaître le contenu initial d'un champ Combo par programmation.
TriéePermet de savoir si un champ Combo par programmation est triée et de trier un champ Combo par programmation.
Champ Combo Fichier uniquement
FichierParcouruPermet de connaître et de modifier le fichier de données ou la requête utilisé pour l'affichage des enregistrements dans les champs Combo fichier.
ParcoursAutoPermet de savoir si le parcours d'un champ Combo fichier est automatique ou programmé.
RubriqueAffichéePermet de connaître ou de modifier la rubrique affichée dans un champ Combo.
RubriqueMémoriséePermet de connaître ou de modifier la rubrique mémorisée d'un champ Combo.
RubriqueParcouruePermet de connaître et de modifier la rubrique utilisée pour le parcours automatique des champs Combo.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Combo, consultez Propriétés associées au champ Combo.
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