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 Interrupteur
  • Présentation
  • Initialiser les différentes options d'un champ Interrupteur
  • Récupérer la valeur d'une option d'un champ Interrupteur
  • En WINDEV et WINDEV Mobile
  • En WEBDEV
  • Modifier les couleurs d'un champ Interrupteur par ligne
  • Modifier les caractéristiques d'un libellé
  • Propriétés spécifiques aux champs Interrupteur
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 Interrupteur directement par programmation. Il suffit d'utiliser directement la variable du champ Interrupteur dans le code.
La variable du champ Interrupteur correspond au nom du champ Interrupteur. Cette variable est de type entier.
WINDEVAndroidiPhone/iPad Remarque : Plusieurs fonctions WLangage permettent d'ajouter, d'insérer ou de supprimer des options dans un champ Interrupteur. Pour plus de détails, consultez Fonctions de gestion des champs Interrupteur.
Initialiser les différentes options d'un champ Interrupteur
Par défaut, à l'affichage d'un champ Interrupteur, aucune option n'est cochée.
Pour cocher une option d'un champ Interrupteur, vous pouvez utiliser :
  • l'affectation directe :
    <Champ Interrupteur>[Indice de l'option] = 1

    <Champ Interrupteur>[Indice de l'option] = Vrai
  • la propriété Valeur :
    <Champ Interrupteur>[Indice de l'option].Valeur = Vrai


    <Champ Interrupteur>[Indice de l'option].Valeur = 1
Pour décocher une option d'un champ Interrupteur, vous pouvez utiliser :
  • l'affectation directe :
    <Champ Interrupteur>[Indice de l'option] = 0

    <Champ Interrupteur>[Indice de l'option] = Faux
  • la propriété Valeur.
    <Champ Interrupteur>[Indice de l'option].Valeur = 0

    <Champ Interrupteur>[Indice de l'option].Valeur = Faux
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 Interrupteur à une rubrique.
WINDEV Si l'état indéterminé d'une option est géré (onglet "Détail" de la description du champ ou propriété TroisEtats), pour initialiser l'option dans le mode indéterminé, utilisez la syntaxe suivante :
<Champ Interrupteur>[Indice de l'option] = -1
Récupérer la valeur d'une option d'un champ Interrupteur
WINDEVWINDEV MobileUniversal Windows 10 AppAndroidiPhone/iPadJava

En WINDEV et WINDEV Mobile

Pour récupérer la valeur d'une option, utilisez la syntaxe suivante :
<Valeur_Option> = <Champ Interrupteur>[Indice de l'option]

Dans ce cas, le paramètre <Valeur_Option> est un booléen qui vaut :
  • Vrai (1) si la case est cochée,
  • Faux (0) si la case n'est pas cochée.
  • WINDEVWindows -1 si la case est indéterminée (si cet état est géré pour l'option).
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 la fonction <Fenêtre>.VersFichier. Pour plus de détails, consultez Lier un champ Interrupteur à une rubrique.
WEBDEV - Code ServeurPHP

En WEBDEV

Pour récupérer la valeur d'une option, vous pouvez utiliser :
  • l'affectation directe.
    <Valeur_Option> = <Champ Interrupteur>[Indice de l'option]
  • la propriété Valeur.
    <Valeur_Option> = <Champ Interrupteur>[Indice de l'option].Valeur
Dans ce cas, le paramètre <Valeur_Option> est un booléen qui vaut :
  • Vrai (1) si la case est cochée,
  • Faux (0) si la case n'est pas cochée.
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 la fonction <Page>.VersFichier. Pour plus de détails, consultez Lier un champ Interrupteur à une rubrique.
WINDEV
Modifier les couleurs d'un champ Interrupteur par ligne
Pour modifier les couleurs d'un champ Interrupteur par ligne, il est possible d'utiliser la syntaxe suivante :
<Champ Interrupteur>.Libellé = gStylo(<Couleur option 1>) + <Libellé option 1> + TAB + ...
gStylo(<Couleur option N>) + <Libellé option N>

Le paramètre <Couleur option> correspond :
Modifier les caractéristiques d'un libellé
La propriété Libellé permet de :
  • changer le libellé du champ Interrupteur :
    <Champ Interrupteur>.Libellé = <Libellé du champ>
  • changer le libellé de toutes les options du champ Interrupteur :
    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 Interrupteur>.Libellé = <Option 1> + TAB + <Option 2> + TAB + <Option 3> ...
  • changer le libellé d'une option :
    <Champ Interrupteur>[Indice de l'option].Libellé = <Nouveau libellé de l'option>
  • récupérer le libellé d'une option :
    <Libellé de l'option> = <Champ Interrupteur>[Indice de l'option].Libellé
WINDEViPhone/iPad Si le champ Interrupteur utilise un mode d'affichage avec des images et/ou des sous-libellés, il est possible de :
  • connaître et modifier l'image de l'option grâce à la propriété Image :
    <Champ Interrupteur>[Indice de l'option].Image = <Nouvelle image>
  • connaître et modifier le sous-libellé de l'option grâce à la propriété SousLibellé :
    <Champ Interrupteur>[Indice de l'option].SousLibellé = <Nouveau sous-libellé>
  • connaître et modifier la hauteur de l'option grâce à la propriété Hauteur :
    <Champ Interrupteur>[Indice de l'option].Hauteur = <Nouvelle hauteur en pixels>
Propriétés spécifiques aux champs Interrupteur
Les propriétés suivantes sont spécifiques à la gestion des caractéristiques d'un champ Interrupteur 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 des options du champ Interrupteur.
CouleurFondPermet de connaître et de modifier la couleur de fond du champ Interrupteur.
HauteurPermet de connaître et de modifier la hauteur de l'option (pour les champs Interrupteur utilisant un mode d'affichage avec une image et/ou un sous-libellé).
ImagePermet de connaître et de modifier l'image associée à une option (si le champ Interrupteur utilise un mode d'affichage avec une image).
LibelléPermet de connaître et de modifier le libellé du champ Interrupteur ou d'une option du champ Interrupteur.
NombreColonnePermet de connaître le nombre de colonnes du champ Interrupteur.
OccurrencePermet de connaître le nombre d'options présentes dans un champ Interrupteur.
SousLibelléPermet de connaître et de modifier le sous-libellé d'une option (si le champ Interrupteur utilise un mode d'affichage avec des sous-libellés).
TroisEtatsPermet de gérer les trois états d'une option d'un champ Interrupteur (coché, décoché, indifférent).
ValeurInitialePermet de connaître la valeur initiale d'un champ Interrupteur.

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