Aller au contenu principal
Version: 20 R5 BETA

Bouton radio

Les boutons radio sont des objets qui permettent à l’utilisateur de sélectionner une valeur parmi un groupe de valeurs.

Un bouton radio apparaît sous la forme d’un texte suivi d’un cercle. However, radio buttons can have various appearances.

Un bouton radio est sélectionné :

  • lorsque l'utilisateur clique dessus
  • when it has the focus and the user presses the Space bar key.

Configuration des boutons radio

Les boutons radio sont utilisés sous forme d’ensembles coordonnés : un seul bouton peut être sélectionné à la fois parmi l’ensemble. In order to operate in a coordinated manner, a set of radio buttons must share the same Radio Group property.

Les boutons radio sont contrôlés par des méthodes. Comme pour tous les boutons, la variable associée au bouton radio est initialisée à 0 (zéro) lorsque le formulaire est ouvert pour la première fois. Une méthode associée à un bouton radio est exécutée lorsqu’il est sélectionné. L’exemple suivant représente des boutons radio utilisés dans une base de données d’enregistrements audio et se rapporte à la vitesse d’enregistrement :

Sélectionner un bouton radio d’un groupe met ce bouton à 1 et les autres boutons du groupe à 0. Un seul bouton radio du groupe peut être sélectionné à la fois.

You can associate Boolean type expressions with radio buttons. Dans ce cas, lorsqu'un bouton radio d'un groupe est sélectionné, sa variable est True et les variables des autres boutons radio du groupe sont False.

La valeur contenue dans un objet bouton radio n’est pas sauvegardée automatiquement (hormis s'il s'agit de la représentation d'un champ booléen) ; les valeurs des boutons radio doivent être stockées dans leurs variables et gérées à l’aide de méthodes.

Styles de bouton

Radio button styles control radio button's general appearance as well as its available properties. Il est possible d'appliquer différents styles prédéfinis aux boutons radio. Cependant, le même style de bouton doit être appliqué à tous les boutons radio d'un groupe afin qu'ils fonctionnent comme prévu.

4D propose des boutons radio dans les styles prédéfinis suivants :

Classique

The Regular radio button style is a standard system button (i.e., a small bullseye with text) which executes code when a user clicks on it.

En plus de lancer l'exécution du code, le style de bouton radio Classique change la couleur de la bulle lors du survol.

A plat

The Flat radio button style is a standard system button (i.e., a small bullseye with text) which executes code when a user clicks on it.

Par défaut, le style A plat a une apparence minimaliste. Le style graphique du bouton A plat est particulièrement utile pour les formulaires à imprimer.

Toolbar (Barre d’outils)

Le style du bouton radio Barre d'outils est initialement destiné à être intégré dans une barre d'outils.

Par défaut, le style bouton Barre d'outils a un fond transparent avec un libellé au centre. En fonction du système d'exploitation, le design du bouton peut changer lorsque la souris le survole :

  • Windows - the button is highlighted.

  • macOS - the highlight of the button never appears.

Bevel

The Bevel radio button style is similar to the Toolbar style's behavior, except that it has a light gray background and a gray outline. En fonction du système d'exploitation, le design du bouton peut changer lorsque la souris le survole :

  • Windows - the button is highlighted.

  • macOS - the highlight of the button never appears.

Bevel arrondi

The Rounded Bevel button style is nearly identical to the Bevel style except, depending on the OS, the corners of the button may be rounded.

  • Windows - the button is identical to the Bevel style.

  • macOS - the corners of the button are rounded.

OS X Gradient

The OS X Gradient button style is nearly identical to the Bevel style except, depending on the OS, it may have a two-toned appearance.

  • Windows - the button is identical to the Bevel style.

  • macOS - the button is displayed as a two-tone system button.

OS X Texture

The OS X Textured radio button style is nearly identical to the Toolbar style except, depending on the OS, it may have a different appearance and does not display hover.

Par défaut, le style OS X Textured apparaît comme :

  • Windows - a toolbar-like button with a label in the center and the background is always displayed.

  • macOS - a standard system button displaying a color change from light to dark gray. Sa hauteur est prédéfinie : il n'est pas possible de l'agrandir ou de la réduire.

Office XP

The Office XP button style combines the appearance of the Regular style (standard system button) with the Toolbar style's behavior.

Les couleurs (surbrillance et arrière-plan) d'un bouton au style Office XP sont basées sur les couleurs du système. En fonction du système d'exploitation, le design du bouton peut changer lorsque la souris le survole :

  • Windows - its background only appears when the mouse rolls over it.

  • macOS - its background is always displayed.

Contracter/Déployer

Ce style de bouton peut être utilisé pour ajouter une icône standard contracter/déployer. Ces boutons sont utilisés nativement dans les listes hiérarchiques. Sous Windows, le bouton ressemble à un [+] ou un [-]; sous macOS, cela ressemble à un triangle pointant vers la droite ou vers le bas.

info

The Collapse/Expand style is named "disclosure" in the button style JSON Grammar.

Disclosure

Le style de bouton radio disclosure affiche le bouton radio comme un bouton disclosure standard, généralement utilisé pour afficher/masquer des informations supplémentaires. Le symbole du bouton pointe vers le bas avec la valeur 0 et vers le haut avec la valeur 1.

info

The Disclosure style is named "roundedDisclosure" in the button style JSON Grammar.

Personnalisé

The Custom radio button style accepts a personalized background picture and allows managing additional parameters such as icon offset and margins.

Propriétés prises en charge

Tous les boutons radio partagent une même série de propriétés de base :

Bold - Bottom - Button Style - Class - Expression Type - Focusable - Font - Font Color - Height - Help Tip - Horizontal Alignment(1) - Horizontal Sizing - Image hugs title(2) - Italic - Left - Number of States(2) - Method - Object Name - Radio Group - Picture pathname(2) - Right - Save value - Shortcut - Title - Title/Picture Position(2) - Top - Type - Underline - Variable or Expression - Vertical Sizing - Visibility - Width

(1) Not supported by the Regular and Flat styles.
(2) Not supported by the Regular, Flat, Disclosure and Collapse/Expand styles.

Additional specific properties are available depending on the button style: