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
  • SELON pré-rempli sur les champs Sélecteur
  • Modifier le libellé d'un champ Sélecteur
  • 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.
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.
WEBDEV - Code Serveur

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.

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é>
Modifier les couleurs des libellés des options d'un champ Sélecteur
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 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