PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
  • WINDEVWindows MobileUniversal 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.
WINDEVWindows MobileUniversal 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.
Versions 18 et supérieures
WINDEViPhone/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.
Nouveauté 18
WINDEViPhone/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.
WINDEViPhone/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.
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 :
    <Nom du 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 :
    <Nom du 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 Lier un champ Sélecteur à une rubrique.
WINDEVWEBDEV - Code ServeurAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava

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 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 Option> = <Nom du sélecteur>

Dans ce cas, le paramètre <Indice 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> = <Nom du sélecteur>[<Nom du 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.
WINDEVWindows MobileUniversal Windows 10 App

Cas d'un sélecteur renvoyant une valeur

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

Dans ce cas, le paramètre <Valeur 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 _A_ 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 sélecteur, utilisez la syntaxe suivante :
<Libellé de l'option> = <Nom du 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.
Versions 18 et supérieures

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 sélecteur. Le libellé de chaque option est ajouté automatiquement en commentaire de la ligne.
Quelques exemples :
  • Code pour un sélecteur renvoyant un entier : la saisie de "SELON SEL_Civilité" sous l'éditeur de code affiche :
    Code pour un sélecteur renvoyant un entier
  • Code pour un sélecteur renvoyant une valeur : la saisie de "SELON SEL_PlatDuJour" sous l'éditeur de code affiche :
    Code pour un sélecteur renvoyant une valeur
Nouveauté 18

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 sélecteur. Le libellé de chaque option est ajouté automatiquement en commentaire de la ligne.
Quelques exemples :
  • Code pour un sélecteur renvoyant un entier : la saisie de "SELON SEL_Civilité" sous l'éditeur de code affiche :
    Code pour un sélecteur renvoyant un entier
  • Code pour un sélecteur renvoyant une valeur : la saisie de "SELON SEL_PlatDuJour" sous l'éditeur de code affiche :
    Code pour un sélecteur renvoyant une valeur

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 sélecteur. Le libellé de chaque option est ajouté automatiquement en commentaire de la ligne.
Quelques exemples :
  • Code pour un sélecteur renvoyant un entier : la saisie de "SELON SEL_Civilité" sous l'éditeur de code affiche :
    Code pour un sélecteur renvoyant un entier
  • Code pour un sélecteur renvoyant une valeur : la saisie de "SELON SEL_PlatDuJour" sous l'éditeur de code affiche :
    Code pour un 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 :
    <Nom du 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.
    <Nom du 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é> = <Nom du sélecteur>[<Indice de l'option>]..SousLibellé

    // Modification du sous-libellé
    <Nom du sélecteur>[<Indice de l'option>]..SousLibellé = <nouveau sous-libellé>
WINDEViPhone/iPadWindows MobileUniversal Windows 10 App

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é> = <Nom du sélecteur>[<Indice de l'option>]..SousLibellé

// Modification du sous-libellé
<Nom du sélecteur>[<Indice de l'option>]..SousLibellé = <Nouveau sous-libellé>
Modifier les couleurs des libellés des options d'un champ Sélecteur
WINDEVWindows MobileJava Pour modifier les couleurs des libellés des options d'un champ Sélecteur, il est possible d'utiliser la syntaxe suivante :
<Nom du champ>..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 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire