DESCRIPTION.

Créer un nouveau controle de type bouton radio permettant un choix dans un groupe d'options (widget : tkinter.Radiobutton ( )).

SYNTAXE.

RAD_Choix = tkinter.Radiobutton ( parent , attribut1 = valeur , ... , attributn = valeur )

RAD_Choix = ⇨ affectation de l'instance du controle [ optionnel ]

tkinter.Radiobutton ( ) ⇨ création d'une instance de tkinter.Radiobutton ( ) [ OBLIGATOIRE ]

parent ⇨ conteneur de l'instance de tkinter.Radiobutton ( ) [ OBLIGATOIRE ]

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

REMARQUES.

Les boutons radio permettent de proposer à l'utilisateur de choisir une, et une seule, option parmi plusieurs dans un groupes de propositions.

Les boutons radios doivent appartenir à un groupe, créer grâce à leur variable de controle défini par leur attribut variable. Dans un groupe donné, un seul bouton radio peut être activé (sélectionné) parmi tous les boutons radio associés à la même variable de controle. Activer (sélectionner / choisir) un bouton radio dans un groupe désélectionne automatiquement le bouton radio du groupe actif à ce moment là. 

Un bouton radio comprend deux parties :

- l'étiquette, qui présente le choix correspondant au bouton radio ;

- l'indicateur, qui précise quel bouton radio du conteneur est actif actuellement.

Un bouton radio peut (devrait) avoir une valeur, unique dans son groupe, affectée avec l’attribut value. La variable de controle recevra la valeur défini par l'attribut value du bouton sélectionné. Cette valeur doit être valide pour le type de variable de controle associée à l'option : 

- un bool ( ), pour une variable de controle de type tkinter.BooleanVar ( ) ;

- un int ( ), pour une variable de controle de type tkinter.IntVar ( ), par défaut valeur vaut 1 ;

- un float ( ), pour une variable de controle de type tkinter.DoubleVar ( ) ;

- un str ( ), pour une variable de controle de type tkinter.StringVar ( )..

Au démarrage de l'application, il est conseillé de donner une valeur de départ, par défaut, à la variable de controle définissant le groupe, en utilisant la méthode .set ( valeur ) de la variable de controle. Le bouton radio ayant cette valeur associée à son attribut value sera ainsi coché dans l'interface. Pour désélectionner tous les boutons d'un groupe, il faut donner la valeur None à la variable de controle : .set ( None ).

Les objets permanents de type tkinter.Radiobutton ( ) sont identifiés dans le site par : RAD_. 

Voir les conventions sur les variables utilisées dans ce site ...

EXEMPLE.

import tkinter

TKI_Principal = tkinter.Tk ( )

TKV_Choix = tkinter.StringVar ( )

for kchoix in ( "Fort" , "Bien" , "Moyen" , "Faible", "Mauvais" ) :

tkinter.Radiobutton ( TKI_Principal , text = kchoix , value = kchoix , variable = TKV_Choix , justify = "left" , anchor = "w" ).pack ( fill = "x" )

tkinter.Label ( TKI_Principal , textvariable = TKV_Choix , bg = "white" , relief = "solid" ).pack ( fill = "both" , pady = 7 )

tkinter.Button ( TKI_Principal , text = "Quitter" , command = TKI_Principal.destroy ).pack ( )

TKV_Choix.set ( "Moyen" )

TKI_Principal.mainloop ( )