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 du Champ Interrupteur
  • Champ Interrupteur dans une fenêtre/page
  • Créer un champ de type Interrupteur
  • Modes d'affichage proposés
  • Interrupteur à trois états
  • Limites du champ Interrupteur en Java
  • Limites en Android et iOS
  • Champ Interrupteur dans un état
  • Utilisation d'un champ Interrupteur
  • Interrupteur dans un champ Table
  • Colonne de champ Table de type "Interrupteur"
  • Champ Interrupteur et data binding
  • Permuter
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 du Champ Interrupteur
Un interrupteur peut correspondre :
  • à un champ permettant à l'utilisateur de répondre à une question par oui ou non dans une fenêtre ou une page.
  • à une colonne d'un champ Table permettant à l'utilisateur de sélectionner une ou plusieurs lignes d'un champ Table.
  • à une case à cocher affichée dans un état.
  • à une case à cocher interactive affichée dans un état formulaire.
Champ Interrupteur dans une fenêtre/page
Sous l'éditeur de fenêtres ou de pages, le champ Interrupteur est un champ permettant à l'utilisateur de répondre à une question par oui ou non :
  • si l'option est cochée, l'option est à Vrai.
  • si l'option est décochée, l'option est à Faux.
Un interrupteur peut afficher jusqu'à 256 options. L'utilisateur sélectionne les options voulues. Pour chaque option, l'interrupteur renvoie l'état de l'option.
Exemple :
Exemple d'interrupteur

Créer un champ de type Interrupteur

Pour créer un champ de type Interrupteur :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "Interrupteur".
  2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé. Le champ apparaît en création.
Astuce : Il est également possible de créer directement un champ Interrupteur "pré-formaté" en déroulant "Interrupteur". La liste des champs disponibles avec leur aperçu au gabarit du projet apparaît. Il suffit de cliquer sur le champ voulu pour le créer dans l'éditeur.
Cette liste propose de créer des interrupteurs à bascule. Pour plus de détails, consultez Champ Interrupteur à bascule.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
WINDEV Remarque : Il est possible de gérer soit une bulle d'aide générale pour le champ, soit une bulle d'aide pour chacune des options du champ (onglet "Aide").
WindowsLinuxUniversal Windows 10 AppiPhone/iPad

Modes d'affichage proposés

WINDEV et WINDEV Mobile proposent différents types d'affichage des champs Interrupteur :
  • interrupteur standard,
  • interrupteur standard avec sous-libellés,
  • interrupteur images (avec possibilité d'utiliser une image sur chaque option),
  • interrupteur images avec sous-libellé (avec possibilité d'utiliser une image sur chaque option).
LinuxUniversal Windows 10 App Les champs Interrupteurs avec images ne sont pas disponibles.
Les différents onglets de la fenêtre de description du champ permettent de paramétrer le champ :
  • Le mode d'affichage du champ Interrupteur est sélectionné dans l'onglet "Général" de la description du champ.
  • L'onglet "Détail" permet de :
    • Paramétrer un interrupteur à trois états,
    • Configurer les options du champ Interrupteur,
    • Configurer le mode image :
      • Dimension de la zone image et nombre d'états de l'image.
      • Options d'affichage du bandeau de sélection.
  • L'onglet "Contenu" permet de saisir les caractéristiques propres au mode d'affichage (image, sous-libellé, hauteur de ligne, etc.) dans les différentes langues de l'application. Ces éléments sont modifiables par programmation.
  • L'onglet "Style" permet de définir certaines caractéristiques propres au mode d'affichage. Il est par exemple possible de définir :
    • l'écart entre le libellé et le sous-libellé (élément "Sous-libellé des options").
    • la position du texte des options : en haut, en bas, ... (élément "Texte des options").
    • la position de la coche : en haut, en bas, ... (élément "Cadre de la coche").
Selon le type d'affichage choisi, le mode de programmation peut varier. Pour plus de détails, consultez Manipuler un interrupteur par programmation.
AndroidiPhone/iPad Pour les applications iPhone/iPad et pour les applications Android, il est possible de créer :
  • des interrupteurs standard.
  • iPhone/iPad des interrupteurs standard avec sous-libellés.
  • des interrupteurs natifs. Dans ce cas, l'interrupteur utilisera le look iOS ou Android. Pour obtenir un interrupteur natif, cochez l'option "Interrupteur natif" dans l'onglet "Détail" de la fenêtre de description du champ.
WindowsLinuxUniversal Windows 10 App

Interrupteur à trois états

Sous l'éditeur de fenêtres, il est possible de gérer trois états pour les options des champs Interrupteur.
Interrupteur à trois états
En exécution, un clic sur une option décochée cochera l'option, un second clic sur cette même option lui donnera une valeur indéterminée. Dans ce cas, l'option renvoie la valeur -1.
Pour que votre champ Interrupteur possède des options à trois états :
  • cochez l'option correspondante dans l'onglet "Détail" de la fenêtre de description du champ Interrupteur. La totalité des options de l'interrupteur géreront les trois états.
  • par programmation, utilisez la propriété TroisEtats sur une des options de l'interrupteur. Cette option gérera les trois états.
Java

Limites du champ Interrupteur en Java

En Java, les caractéristiques suivantes ne sont pas gérées :
  • interrupteur à trois états.
  • colonnes proportionnelles (si les options de l'interrupteur sont affichées sur plusieurs colonnes).
  • libellé des options de l'interrupteur multiligne.
  • texte des options de l'interrupteur avec mise en forme (R. T. F.).
  • numéro d'aide associé à chaque option de l'interrupteur.
  • différents modes d'affichage de l'interrupteur. Seul l'interrupteur standard est disponible.
AndroidiPhone/iPad

Limites en Android et iOS

Seules les images sont supportées pour les coches des options. Si aucune image n'est spécifiée, c'est l'image système qui est utilisée. Les éléments "Coche" et "Cadre de la coche" dans le style des champs Interrupteur sont ignorés.
Champ Interrupteur dans un état
WINDEVWEBDEV - Code ServeuriPhone/iPad Sous l'éditeur d'états, le champ Interrupteur correspond à une case à cocher :
  • Si la valeur du champ est à Vrai, la case est cochée :
  • Si la valeur du champ est à Faux, la case est décochée :
Deux types de champs Interrupteur sont disponibles dans l'éditeur d'états :
  • Champ Interrupteur classique, qui est présent uniquement en affichage dans l'état.
  • Champ Interrupteur modifiable, qui pourra être coché / décoché par l'utilisateur. Ce champ est utilisable dans :
    • WINDEV le visualisateur de rapports,
    • les fichiers PDF générés.
Pour créer un champ de type Interrupteur :
  • Méthode 1 : Création par défaut d'un champ Interrupteur classique :
    1. Sous le volet "Création", dans le groupe "Visuel", cliquez sur "Interrupteur".
    2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
  • Méthode 2 : Création par défaut d'un champ Interrupteur modifiable :
    1. Sous le volet "Création", dans le groupe "Interactions", cliquez sur "Interrupteur".
    2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Remarque : Il est possible de changer directement le type d'un champ Interrupteur :
  1. Affichez la fenêtre de description du champ.
  2. Dans l'onglet "UI", sélectionnez ou désélectionnez l'option "Modifiable (état formulaire)".
  3. Validez.
WINDEVWEBDEV - Code ServeuriPhone/iPad

Utilisation d'un champ Interrupteur

Pour que le champ Interrupteur s'affiche correctement sur le poste des utilisateurs finaux, la police Wingdings doit être installée sur leur machine.
Interrupteur dans un champ Table
WINDEVWEBDEV - Code ServeurJava

Colonne de champ Table de type "Interrupteur"

Pour permettre uniquement de cocher ou non l'interrupteur lors du clic sur la colonne "Interrupteur" :
  1. Le champ Table doit être en saisie.
  2. La colonne "Interrupteur" doit être en saisie.
  3. Toutes les autres colonnes du champ Table doivent être en affichage.
Utilisation d'une colonne Interrupteur dans un champ Table :
Si vous utilisez une colonne Interrupteur dans un champ Table fichier, le comportement suivant peut être observé :
  • Les interrupteurs des lignes visibles sont bien cochés.
  • A chaque déplacement de l'ascenseur du champ Table, les interrupteurs des lignes sont automatiquement décochés.
Ce comportement indique que l'interrupteur n'est pas lié à une rubrique du fichier de données.
Pour gérer un interrupteur dans un champ Table, vous devez :
  • soit prévoir une rubrique dans votre fichier de données (type interrupteur par exemple). Dans ce cas, il est possible de gérer cette rubrique dans un champ Table fichier.
  • soit créer un champ Table par programmation.
Champ Interrupteur et data binding
Le data binding est disponible sur les champs de type Interrupteur sous les conditions suivantes :
  • si le champ Interrupteur possède une seule option, il devra être relié à une variable simple.
  • si le champ Interrupteur possède plusieurs options, il devra être relié à un tableau.
Si cette condition n'est pas respectée, une erreur d'UI sera générée.
Permuter
WINDEV, WINDEV Mobile et WEBDEV permettent de transformer automatiquement un champ Interrupteur en un champ Sélecteur et inversement :
  1. Sélectionnez le champ à transformer dans la fenêtre ou dans la page.
  2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Sélecteur / Interrupteur".
Liste des exemples associés :
Le champ Interrupteur Exemples unitaires (WINDEV) : Le champ Interrupteur
[ + ] Utilisation d'un champ Interrupteur.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 29/05/2024

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