Le guide Oracle Forms 9i/10g

Un ensemble de boutons radio est géré par un conteneur appelé groupe de boutons.
Le fonctionnement typique de ce type de bouton est de procurer une interface de choix exclusif. En effet la sélection d'un bouton dans un groupe désélectionne automatiquement tout autre bouton du même groupe.

Ce type d'item est idéal pour représenter plusieurs valeurs dont une seule peut être stockée en base. Il s'agit d'un choix mutuellement exclusif.

Dans une application Forms 9i/10g, c'est le bouton option qui est manipulé par l'utilisateur, mais c'est le groupe de boutons qui stocke la valeur.

Un item de type groupe de boutons ne peut représenter qu'une seule valeur. C'est le regroupement de plusieurs boutons dans un groupe qui présente à l'utilisateur tous les choix (et donc toutes les valeurs) permises.

Lorsque la valeur stockée dans la colonne correspond à celle du bouton option, celui-ci prend l'aspect "sélectionné". lorsque la valeur ne correspond pas le bouton option a l'aspect "non sélectionné".
De la même façon, lorsque l'utilisateur clique l'un des boutons du groupe, c'est la valeur de ce bouton qui sera stockée en base à l'enregistrement.

Créer un Groupe de boutons

Depuis le navigateur d'objet:

Pointer le nœud Eléments du bloc désiré puis sur le bouton
La propriété Type d'élément doit être valorisée à Groupe de boutons option

Depuis l'éditeur de présentation:

Sélectionner le canevas et le bloc de réception de l'item.
Cliquer l'icône
Dessiner sur le canevas un rectangle avec la souris pour délimiter les dimensions de l'item

Propriétés spécifiques de l'item Groupe de boutons:

Il n'y a pas de propriétés spécifiques concernant le groupe de boutons.
Il ne possède ni libellé ni invite. En fait, il n'apparaît graphiquement pas dans l'interface.
Il stocke simplement la valeur sélectionnée par le choix d'un des boutons option du groupe.

C'est pourtant lui qui correspond à la colonne de la table si l'item est basé.

Propriétés spécifiques d'un bouton option:

Libellé représente le libellé situé à droite du bouton. A la différence de l'invite, le libellé est cliquable (il fait parti de la zone sensible permettant de sélectionner/désélectionner l'item).
Cette propriété peut être modifiée à l'exécution via l'instruction:
Set_Radio_Button_Property( nom_item | id_item, LABEL, libelle).
Touche d'accès permet de spécifier la lettre qui, en conjonction avec la touche Alt permettra d'activer la sélection.
Cette propriété ne peut être modifiée à l'exécution.
Valeur du bouton d'option permet d'indiquer la valeur correspondant au bouton option.
Cette propriété ne peut être modifiée à l'exécution.
Invite permet d'associer un libellé au bouton option, mais ce libellé ne fait pas partie de la zone sensible.
Cette propriété peut être modifiée à l'exécution via l'instruction:
Set_Radio_Button_Property( nom_item | id_item, PROMPT_TEXT, libelle).


Valoriser un groupe de boutons

Pour donner une valeur au groupe de boutons, il faut valoriser le groupe (GROUPE_BOUTONS dans notre exemple et non pas le bouton option lui-même)
:BLOC3.GROUPE_BOUTONS := 2 ;
:BLOC3.GROUPE_BOUTONS := 'Interne' ;

Récupérer la valeur d'un groupe de boutons

LN$Valeur := :BLOC3.GROUPE_BOUTONS ;

Remarque:
Aucune fonction native n'est prévue pour récupérer la liste des options contenues dans un groupe.


Modifier à l'exécution un bouton option

Utiliser la fonction:
Set_Radio_Button_Property( nom_groupe | id_groupe, nom_bouton_option, propriete, valeur ) ;

-- Désactiver une option --
Set_Radio_Button_Property( 'BLOC3.GROUPE_BOUTONS', 'Option_1', ENABLED, PROPERTY_FALSE ) ;
-- Modifier un libellé --
Set_Radio_Button_Property( 'BLOC3.GROUPE_BOUTONS', 'Option_2', LABEL, 'Externes' ) ;

Les déclencheurs liés aux groupes de boutons:

When-Radio-Changed se déclenche dès que l'utilisateur clique l'un des boutons option.
Utilisez ce déclencheur lorsque vous voulez implémenter une action lors du changement de l'un des boutons option.