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 Sélecteur
  • Présentation
  • Initialiser le choix d'un champ Sélecteur
  • Afficher un champ Sélecteur sans option par défaut
  • Récupérer l'option sélectionnée dans un champ Sélecteur
  • Cas d'un champ Sélecteur renvoyant un entier
  • Cas d'un champ Sélecteur renvoyant une valeur
  • SELON pré-rempli sur les champs Sélecteur
  • Modifier le libellé d'un champ Sélecteur
  • Cas des champs Sélecteur avec sous-libellés
  • Modifier les couleurs des libellés des options d'un champ Sélecteur
  • Propriétés spécifiques aux champs Sélecteur
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, WEBDEV et WINDEV Mobile permettent de manipuler un champ Sélecteur directement par programmation. Il suffit d'utiliser directement la variable du champ Sélecteur dans le code.
Quel que soit le type de sélecteur, il est possible d'associer à chaque option :
  • un entier. Cet entier peut prendre une valeur de 1 à N, N étant le nombre total d'options du sélecteur. La première option a le numéro 1, la seconde le numéro 2, ... Les options sont numérotées de haut en bas et de gauche à droite.
  • WINDEVUniversal Windows 10 App une valeur renvoyée spécifique. Cette valeur renvoyée est spécifiée dans l'onglet "Contenu" de la fenêtre de description du champ.
WINDEVUniversal Windows 10 App Utiliser la numérotation ou les valeurs renvoyées ?
La programmation des sélecteurs renvoyant un entier est différente de celle des sélecteurs renvoyant une valeur. L'avantage de l'utilisation des valeurs renvoyées est visible lors de l'insertion ou du déplacement d'une option dans le sélecteur :
  • Si le sélecteur renvoie un entier, l'insertion ou le déplacement d'une option dans le sélecteur oblige à revoir tout le code de gestion de la valeur du sélecteur (pour gérer le décalage des numéros).
  • Si le sélecteur renvoie une valeur spécifique, l'insertion d'une option dans le sélecteur entraîne uniquement la prise en compte de la nouvelle option. Le déplacement d'une option n'entraîne aucune modification.
WINDEVAndroidiPhone/iPad Remarque : Plusieurs fonctions WLangage permettent d'ajouter, d'insérer ou de supprimer des options dans un champ Sélecteur. Pour plus de détails, consultez Fonctions de gestion des champs Sélecteur.
Initialiser le choix d'un champ Sélecteur
Par défaut, à l'affichage d'un champ Sélecteur, la première option est sélectionnée.
Pour cocher une option d'un champ Sélecteur :
  • si le champ Sélecteur renvoie un entier, utilisez la syntaxe suivante :
    <Champ Sélecteur> = <Indice de l'option>
  • si le champ Sélecteur renvoie une valeur spécifique (uniquement sous WINDEV et WINDEV Mobile), utilisez la syntaxe suivante :
    <Champ Sélecteur> = <Valeur de l'option>
La sélection d'une option décoche l'option actuellement sélectionnée.
Remarque : Si le champ est associé à une rubrique d'un fichier de données, l'affectation est automatiquement réalisée en utilisant :
Pour plus de détails, consultez Champ Sélecteur lié à une rubrique.
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppAndroidiPhone/iPadJava

Afficher un champ Sélecteur sans option par défaut

Par défaut, un champ Sélecteur est toujours positionné sur une position (1 par défaut).
Pour afficher un champ Sélecteur sans option par défaut, il suffit d'affecter la valeur initiale du champ à :
  • -1 pour un champ Sélecteur renvoyant un entier,
  • "" (chaîne vide) pour un champ Sélecteur renvoyant une valeur.
Remarque : Par défaut, un champ Sélecteur sans valeur par défaut est inaccessible par TAB.
Exemple :
// Affichage du champ Sélecteur sans valeur initiale
SEL_MonSélecteur = -1 
// ou SEL_MonSélecteur = ""
Récupérer l'option sélectionnée dans un champ Sélecteur

Cas d'un champ Sélecteur renvoyant un entier

Pour récupérer l'indice de l'option sélectionnée dans le champ Sélecteur, utilisez la syntaxe suivante :
<Indice de l'option> = <Champ Sélecteur>

Dans ce cas, le paramètre <Indice de l'option> est un entier correspondant au numéro de l'option sélectionnée.
Pour obtenir le libellé de l'option sélectionnée dans le champ Sélecteur, utilisez la syntaxe suivante :
<Libellé de l'option> = <Champ Sélecteur>[<Champ Sélecteur>].Libellé

Remarque : Si le champ est associé à une rubrique d'un fichier de données, la récupération de la valeur saisie est automatiquement réalisée en utilisant :
Pour plus de détails, consultez Lier un champ Sélecteur à une rubrique.
WINDEVUniversal Windows 10 App

Cas d'un champ Sélecteur renvoyant une valeur

Pour récupérer la valeur de l'option sélectionnée dans le champ Sélecteur, utilisez la syntaxe suivante :
<Valeur de l'option> = <Champ Sélecteur>

Dans ce cas, le paramètre <Valeur de l'option> est une chaîne de caractères correspondant à la valeur renvoyée de l'option sélectionnée.
Remarque : La propriété ValeurRenvoyée permet également de connaître et de modifier la valeur renvoyée par chaque option du champ Sélecteur.
Pour récupérer l'indice de l'option sélectionnée, il est nécessaire de réaliser un traitement spécifique. Exemple :
// Valeur renvoyée de l'option sélectionnée
Résultat1 = SEL_PlatDuJour
// Recherche de l'indice de l'option sélectionnée
Indice est un entier
I est un entier
POUR I = 1 _À_ SEL_PlatDuJour.Occurrence
SI SEL_PlatDuJour[I].ValeurRenvoyée = Résultat1 ALORS Indice = I
FIN
Pour obtenir le libellé de l'option sélectionnée dans le champ Sélecteur, utilisez la syntaxe suivante :
<Libellé de l'option> = <Champ Sélecteur>[<Indice de l'option>].Libellé
Remarque : Si le champ est associé à une rubrique d'un fichier de données, la récupération de la valeur saisie est automatiquement réalisée en utilisant :
Pour plus de détails, consultez Lier un champ Sélecteur à une rubrique.

SELON pré-rempli sur les champs Sélecteur

Lors de la saisie sous l'éditeur de code de l'instruction SELON relative à un champ Sélecteur, l'éditeur de code ajoute automatiquement les CAS correspondant aux différentes options du champ Sélecteur. Le libellé de chaque option est ajouté automatiquement en commentaire de la ligne.
Quelques exemples :
  • Code pour un champ Sélecteur renvoyant un entier : la saisie de "SELON SEL_Civilité" sous l'éditeur de code affiche :
    Code pour un champ Sélecteur renvoyant un entier
  • Code pour un champ Sélecteur renvoyant une valeur : la saisie de "SELON SEL_PlatDuJour" sous l'éditeur de code affiche :
    Code pour un champ Sélecteur renvoyant une valeur
Modifier le libellé d'un champ Sélecteur
La propriété Libellé permet de :
  • changer le libellé du champ Sélecteur :
    <Champ Sélecteur>.Libellé = <Libellé>
  • changer le libellé de toutes les options du champ Sélecteur :
    Chaque option doit être séparée des autres par le caractère TAB.
    Il est possible de spécifier uniquement les premières options.
    <Champ Sélecteur>.Libellé = <Option 1>+TAB+<Option 2>+TAB+<Option 3> ...
  • récupérer et modifier le libellé d'une option :
    // Récupération du sous-libellé
    <Sous-Libellé> = <Champ Sélecteur>[<Indice de l'option>].SousLibellé

    // Modification du sous-libellé
    <Champ Sélecteur>[<Indice de l'option>].SousLibellé = <Nouveau sous-libellé>
WINDEVUniversal Windows 10 AppiPhone/iPad

Cas des champs Sélecteur avec sous-libellés

La propriété SousLibellé permet de connaître et de modifier les sous-libellés des options du champ Sélecteur.
// Récupération du sous-libellé
<Sous-Libellé> = <Champ Sélecteur>[<Indice de l'option>].SousLibellé

// Modification du sous-libellé
<Champ Sélecteur>[<Indice de l'option>].SousLibellé = <Nouveau sous-libellé>
Modifier les couleurs des libellés des options d'un champ Sélecteur
WINDEVJava Pour modifier les couleurs des libellés des options d'un champ Sélecteur, il est possible d'utiliser la syntaxe suivante :
<Champ Sélecteur>.Libellé = gStylo(<Couleur option 1>) + ...
<Libellé option 1> + TAB + ...
gStylo(<Couleur option N>) + <Libellé option N>
Le paramètre <Couleur option> correspond à :
Propriétés spécifiques aux champs Sélecteur
Les propriétés suivantes sont spécifiques à la gestion des caractéristiques d'un champ Sélecteur par programmation.
CadrageHorizontalPermet de connaître et de modifier le cadrage horizontal d'un champ.
CadrageVerticalPermet de connaître et de modifier le cadrage vertical d'un champ.
CouleurPermet de connaître et de modifier la couleur du texte des options du champ Sélecteur.
CouleurFondPermet de connaître et de modifier la couleur de fond du champ Sélecteur.
NombreColonnePermet de connaître le nombre de colonnes du champ Sélecteur.
OccurrencePermet de connaître le nombre d'options présentes dans un champ Sélecteur.
SousLibelléPermet de connaître et de modifier le sous-libellé d'une option d'un champ Sélecteur.
ValeurInitialePermet de connaître la valeur initiale d'un champ Sélecteur.
ValeurRenvoyéePermet de connaître et de modifier la valeur renvoyée par une option d'un champ Sélecteur.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ Sélecteur, consultez Propriétés associées à un champ Sélecteur.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Pour obtenir le libellé de l'option sélectionnée (Valeur renvoyée)
Préférez la création d'un tableau associatif pour ne pas parcourir systématiquement toutes les options du sélecteur.

Dans la déclaration des globales :

gtaIndiceSelecteur est un tableau associatif d'entiers
POUR j = 1 _À_ SEL_Selecteur..Occurrence
gtaIndiceSelecteur[SEL_Selecteur[j]..ValeurRenvoyée] = j
FIN

Puis lors de la récupération du libellé:

SEL_Selecteur[gtaIndiceSelecteur[SEL_Selecteur]]..Libellé
Toucau
04 sep. 2020

Dernière modification : 25/05/2022

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