Cases à cocher

4D v20 R7

Cases à cocher

Utilisation

Une case à cocher est utilisée pour saisir ou afficher une donnée binaire (vrai-faux). Une case à cocher est un type de bouton. Une case à cocher peut être soit sélectionnée soit désélectionnée. L’effet d’une case à cocher est contrôlé par une méthode. Comme tous les boutons, une case à cocher est initialisée à la valeur zéro lorsque le formulaire est ouvert pour la première fois. La méthode associée à une case à cocher est exécutée lorsqu’elle est cochée.

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).

Lorsque l’utilisateur clique sur l’objet, la case est cochée. Lorsqu’une case à cocher est cochée, sa valeur est 1. Lorsqu’elle n’est pas cochée, elle a la valeur zéro.
Vous pouvez également associer une variable de type booléen à la case à cocher. Dans ce cas, lorsque la case est cochée, la variable est à Vrai, elle est à Faux lorsque la case n'est pas cochée.
Toute case à cocher d’un formulaire peut prendre un de ces deux états.

Plusieurs cases à cocher permettent à l’utilisateur de sélectionner plusieurs options.

A la différence d’un champ booléen affiché sous forme de case à cocher, les valeurs de la variable de la case à cocher ne sont pas automatiquement stockées. Il est nécessaire d’utiliser une méthode pour gérer la variable.

Note : Les cases à cocher 3D ont un fonctionnement identique aux cases à cocher mais leur apparence (par exemple la représentation de l’état coché/non coché) est définie par les propriétés de la famille des boutons 3D. Pour plus d’informations, reportez-vous au paragraphe Boutons 3D, Cases à cocher 3D et Boutons radio 3D.

Cases à cocher à trois états

Les objets de type case à cocher 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 standard associées à des variables numériques — les cases à cocher 3D et les cases à cocher de représentation des champs booléens sont exclues de ce principe (un champ booléen 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.

Astuce : 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 ou une case à cocher 3D (via la commande OBJET FIXER ACTION ou le thème "Action" de la Liste des propriétés) 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.

Note : L'option "Trois états" est prise en charge par les cases à cocher uniquement, pas les cases à cocher 3D.

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
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.