Case à cocher
Une case à cocher est un type de bouton utilisée pour saisir ou afficher une donnée binaire (vrai-faux). Fondamentalement, elle est soit cochée, soit décochée, mais un troisième état peut être défini.
Les cases à cocher sont contrôlées par des méthodes ou des actions standard. La méthode associée à une case à cocher est exécutée lorsqu’elle est cochée. Comme tous les boutons, une case à cocher est initialisée à la valeur zéro lorsque le formulaire est ouvert pour la première fois.
Une case à cocher affiche généralement du texte en face de la case. Ce texte est défini dans la zone Titre du thème “Objets” de la Liste des propriétés. Vous pouvez saisir dans cette zone un libellé sous forme de référence XLIFF (cf. Annexe B : Architecture XLIFF).
Utiliser une case à cocher
Une case à cocher peut être associée à une variable ou expression de type entier ou booléen.
- entier : si la case est cochée, la variable prend la valeur 1. Lorsqu'elle n'est pas cochée, elle porte la valeur 0. Si la case à cocher a un troisième état (voir ci-dessous), elle porte la valeur 2.
- booléen : si la case est cochée, la variable prend la valeur
Vrai. Lorsqu'elle n'est pas cochée, elle prend la valeurFaux.
Une partie ou la totalité des cases à cocher contenues dans un formulaires peut être cochée ou non cochée. Plusieurs cases à cocher permettent à l'utilisateur de cocher plusieurs options.
Cases à cocher à trois états
Les objets case à cocher avec le style de bouton Normal et Plat acceptent un troisième état. Ce troisième état représente un statut intermédiaire, généralement utilisé pour l’affichage. Il permet par exemple d’indiquer qu’une propriété est présente parmi une sélection d’objets mais pas dans chaque objet de la sélection.
Pour qu’une case à cocher prenne en charge ce troisième état, vous devez lui attribuer la propriété Trois états dans la Liste des propriétés, thème “Affichage” .
Cette propriété n’est disponible que pour les cases à cocher classiques et flat associées à des variables ou expressions numériques — les cases à cocher de représentation des expressions booléennes sont exclues de ce principe (une expression booléenne ne pouvant pas se trouver dans un état intermédiaire).
La variable associée à la case à cocher retourne la valeur 2 lorsque celle-ci se trouve dans le troisième état.
En saisie, les cases à cocher à trois états affichent séquentiellement chaque état, dans l’ordre suivant : non coché / coché / intermédiaire / non coché, etc. L’état intermédiaire étant généralement inutile en saisie ; il vous suffit, dans le code, de “forcer” la valeur de la variable à 0 lorsqu’elle prend la valeur 2 afin de passer directement de l’état coché à l’état non coché.
Utiliser une action standard
Vous pouvez affecter une action standard à une case à cocher pour gérer les attributs des zones de texte. Par exemple, si vous sélectionnez l'action standard fontBold, à l'exécution la case à cocher permettra de gérer l'attribut "gras" du texte sélectionné dans la zone de texte courante.
Seules les actions qui peuvent représenter un statut vrai/faux (actions "à coche") sont prises en charge par cet objet :
| Actions prises en charge | Conditions d'utilisation (le cas échéant) |
|---|---|
| avoidPageBreakInsideEnabled | Zones 4D Write Pro uniquement |
| fontItalic | |
| fontBold | |
| fontLinethrough | |
| fontSubscript | Zones 4D Write Pro uniquement |
| fontSuperscript | Zones 4D Write Pro uniquement |
| fontUnderline | |
| font/showDialog | Mac uniquement |
| htmlWYSIWIGEnabled | Zones 4D Write Pro uniquement |
| section/differentFirstPage | Zones 4D Write Pro uniquement |
| section/differentLeftRightPages | Zones 4D Write Pro uniquement |
| spell/autoCorrectionEnabled | |
| spell/autoDashSubstitutionsEnabled | Mac uniquement |
| spell/autoLanguageEnabled | Mac uniquement |
| spell/autoQuoteSubstitutionsEnabled | Mac uniquement |
| spell/autoSubstitutionsEnabled | |
| spell/enabled | |
| spell/grammarEnabled | Mac uniquement |
| spell/showDialog | Mac uniquement |
| spell/visibleSubstitutions | |
| visibleBackground | Zones 4D Write Pro uniquement |
| visibleFooters | Zones 4D Write Pro uniquement |
| visibleHeaders | Zones 4D Write Pro uniquement |
| visibleHiddenChars | Zones 4D Write Pro uniquement |
| visibleHorizontalRuler | Zones 4D Write Pro uniquement |
| visiblePageFrames | Zones 4D Write Pro uniquement |
| visibleReferences | |
| widowAndOrphanControlEnabled | Zones 4D Write Pro uniquement |
Pour plus d'informations sur ces actions, veuillez vous reporter à la section Actions standard.
Styles des boutons "Case à cocher"
Les cases à cocher utilisent les styles de bouton pour contrôler l'apparence générale de la case à cocher ainsi que ses propriétés disponibles. Il est possible d'appliquer différents styles prédéfinis aux cases à cocher. Plusieurs variantes peuvent être obtenues en combinant ces propriétés/comportements.
À l'exception des propriétés disponibles, de nombreux objets case à cocher sont structurellement identiques. La différence réside dans le traitement de leurs variables associées.
4D propose des cases à cocher avec les styles de bouton prédéfinis suivants :
Classique
Le style Classique du bouton case à cocher correspond à un système de case à cocher standard (i.e., un rectangle avec un titre descriptif) :
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"regular",
"text": "Cancel",
"action": "Cancel",
"left": 60,
"top": 160,
"width": 100,
"height": 20
"dataSourceTypeHint":"boolean"
}
A plat
Le style plat du bouton case à cocher a un design minimaliste. Le graphisme du style A plat est particulièrement utile pour les formulaires à imprimer.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"flat",
"text": "Cancel",
"action": "cancel",
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Bouton barre outils
Le style de bouton Barre d'outils est principalement destiné à l'intégration dans une barre d'outils.
Le style de bouton Barre d'outils a un arrière-plan transparent avec un titre. Il est généralement associé à une image à 4 états.
Exemples avec les états coché / non coché / surligné :
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"toolbar",
"text": "Checkbox",
"icon": "/RESOURCES/File.png",
"iconFrames": 4
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Bevel
La case à cocher Bevel combine l'apparence du style de bouton Classique (c'est-à-dire un rectangle avec un libellé descriptif) et le comportement du style de bouton Barre d'outils.
Le style de bouton Bevel possède un fond gris clair et un titre. Il est généralement associé à une image à 4 états.
Exemples avec les états coché / non coché / surligné :
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"bevel",
"text": "Checkbox",
"icon": "/RESOURCES/File.png",
"iconFrames": 4
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Bevel arrondi
Le style de bouton de la case à cocher Bevel arrondi est presque identique au style de bouton Bevel, à l'exception des coins du bouton qui peuvent, selon le système d'exploitation, être arrondis. Comme pour le style de bouton Bevel, le style de bouton Bevel arrondi combine l'apparence du style de bouton Classique et le comportement du style de bouton Barre outils.
Le style de bouton Bevel arrondi possède un fond gris clair et un titre. Il est généralement associé à une image à 4 états.
Exemple sous macOS :
Sous Windows, le style de bouton Bevel arrondi est identique au style de bouton Bevel.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"roundedBevel",
"text": "Checkbox",
"icon": "/RESOURCES/File.png",
"iconFrames": 4
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
OS X Gradient
Le style du bouton OS X Gradient est presque identique au style du bouton Bevel. Comme pour le style Bevel, le style OS X Gradient combine l'apparence du style Classique et du style Barre outils.
Le style Gradient OS X a un arrière-plan gris clair et un titre et s'affiche sous la forme d'un bouton système bicolore sur macOS. Il est généralement associé à une image à 4 états.
Sous Windows, ce style est identique au style Bevel.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"gradientBevel",
"text": "Checkbox",
"icon": "/RESOURCES/File.png",
"iconFrames": 4
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
OS X Texture
Le style de bouton OS X Textured est presque identique au style Bevel mais avec une taille plus petite (la taille maximale est celle d'un bouton système standard de macOS). Comme pour le style Bevel, le style OS X Textured combine l'apparence du style Classique et du style Barre outils.
Par défaut, le style OS X Textured apparaît comme :
- Windows - un bouton système standard avec un fond bleu clair et un libellé au centre.
- macOS - un bouton système standard. Sa hauteur est prédéfinie : il n'est pas possible de l'agrandir ou de la réduire.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"texturedBevel",
"text": "Checkbox",
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Office XP
Le style de bouton Office XP combine l'apparence du style Classique et du comportement du style Barre outils.
Les couleurs (surbrillance et arrière-plan) d'une case à cocher avec le style de bouton Office XP sont basées sur les couleurs du système. L'apparence de la case à cocher peut être différente lorsque le curseur la survole, selon le système d'exploitation :
- Sous Windows - son arrière-plan n'apparaît que lorsque la souris le survole. Exemples avec les états coché / non coché / surligné :
- Sous macOS - son arrière-plan est toujours affiché. Exemples avec les états cochés / non cochés :
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"office",
"text": "Checkbox",
"action": "fontBold",
"icon": "/RESOURCES/File.png",
"iconFrames": 4
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Contracter/Déployer
Ce style de case à cocher peut être utilisé pour ajouter une icône standard contracter/déployer. Ces icônes sont utilisées nativement dans les listes hiérarchiques.
- Sous Windows - le bouton est semblable à [+] ou à [-]
- Sous macOS - il ressemble à un triangle pointant sur vers la droite ou vers le bas.
Le style contracter/déployer est nommé "disclosure" dans la grammaire JSON du style de bouton.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"disclosure",
"method": "m_collapse",
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Disclosure
Sous macOS et Windows, une case à cocher avec le style "Disclosure" apparaît comme un bouton disclosure standard, généralement utilisé pour afficher/masquer des informations supplémentaires. Lorsqu'il est utilisé comme bouton radio, le symbole du bouton pointe vers le bas avec la valeur 0 et vers le haut avec la valeur 1.
-
Windows
-
macOS
Le style Disclosure est nommé "roundedDisclosure" dans la grammaire JSON du style de bouton.
Exemple JSON :
"myCheckBox": {
"type": "checkbox",
"style":"roundedDisclosure",
"method": "m_disclose",
"left": 60,
"top": 160,
"width": 100,
"height": 20
}
Personnalisé
Le style de case à cocher personnalisé accepte une image d'arrière-plan personnalisée et permet de gérer des propriétés spécifiques :
Il est généralement associé à une image à 4 états, qui peut être utilisée en conjonction avec une image d'arrière-plan à 4 états.
Exemple JSON :
"myCheckbox": {
"type": "checkbox",
"style":"custom",
"text": "OK",
"icon": "/RESOURCES/smiley.jpg",
"iconFrame": 4,
"customBackgroundPicture": "/RESOURCES/paper.jpg",
"iconOffset": 5, //custom icon offset when clicked
"left": 60,
"top": 160,
"width": 100,
"height": 20,
"customBorderX": 20,
"customBorderY": 5
}
Propriétés prises en charge
Toutes les cases à cocher partagent une même série de propriétés de base :
Gras - Bas - Style de bouton - Classe - Entrable - Type d'expression - Focusable - Police - Couleur de police - Taille de police - Hauteur - Astuce d'aide - Alignement horizontal(1) - Dimensionnement horizontal - L'image serre le titre(2) - Italique - Gauche - Nombre d'états(2) - Nom d'objet - Chemin d'accès de l'image(2) - Droite - Enregistrer la valeur - Raccourci - Action standard - Titre - Position du titre/image(2) - Haut - Type - Souligner - Variable ou expression - Dimensionnement vertical - Visibilité - Largeur
(1) Non pris en charge par les styles Regular et Flat.
(2) Non pris en charge par les styles Regular, Flat, Disclosure et Collapse/Expand.
Des propriétés spécifiques supplémentaires sont disponibles, en fonction du style de bouton :
- Personnalisé : Chemin d'accès arrière-plan - Marge horizontale - Décalage de l'icône - Marge verticale
- Flat, Regular: Trois états