DESCRIPTION.

Créer un nouveau controle de type option à cocher (widget : tkinter.Checkbutton ( )).

SYNTAXE.

CKB_Option = tkinter.Checkbutton ( parent , attribut1 = valeur , ... , attributn = valeur )

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

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

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

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

CREATION DES OPTIONS A COCHER.

Voir le tutoriel sur les options à cocher ...

LISTE DES ATTRIBUTS DES OPTIONS A COCHER.

activebackground : couleur de fond lorsque le pointeur est sur le controle.

activeforeground : couleur du premier plan lorsque le pointeur est sur le controle.

anchor : positionne le texte dans le controle.

background ou bg : couleur du fond du controle.

bitmap : Nom de l'image .xbm (BitMap) à afficher dans le controle.

borderwidth ou bd : épaisseur de la bordure du controle.

command : action à effectuer lorsque l'utilisateur clique sur le controle.

compound : positionne de l'image par rapport au texte dans le controle.

cursor : définit l'aspect du pointeur selon sa position.

disabledforeground : couleur de premier plan lorsque le controle est désactivé.

font : police de caractères du texte du controle.

foreground ou fg : couleur du texte du controle.

height : hauteur du controle.

highlightbackground : couleur de la surbrillance quand le controle n'a pas le focus.

highlightcolor : couleur de la surbrillance quand le controle a le focus.

highlightthickness : épaisseur de la surbrillance quand le controle a le focus.

image : image à afficher dans le controle.

indicatoron : aspect l'indicateur de la case, True pour case, False pour bouton poussoir.

justify : alignement d'un texte ayant plusieurs lignes.

offrelief : aspect du bouton quand il est désélectionné.

offvalue : valeur à affecter à la variable associée quand la case à option est décoché.

onvalue : valeur à affecter à la variable associée quand la case à option est coché.

overrelief : aspect du controle lorsque le pointeur de la souris est sur lui.

padx : marge supplémentaire à gauche et à droite du texte.

pady : marge supplémentaire au dessus et en dessous du texte.

relief : aspect du bouton quand il est sélectionné.

selectcolor : définit la couleur de fond quand la case est activée.

selectimage : indique l'image a afficher quand la case est activée.

state : détermine l'état du controle.

takefocus : indique si le controle doit réagir à la touche tabulation.

text : définit le texte à afficher dans le controle.

textvariable : indique la variable associée au controle.

underline : indique quel caractère du texte sera souligné.

variable : variable de controle associée à la valeur de l'option.

width : largeur du controle.

wraplength : indique à qu'elle longueur une ligne de texte doit être coupée.

MÉTHODES SPÉCIFIQUES DES OPTIONS A COCHER.

deselect ( ) : déactive l'option.

flash ( ) : fait clignoter brièvement l'option, sans modifier son état.

invoke ( ) : appel la fonction associée à l'attribut command.

select ( ) : active l'option.

toggle ( ) : inverse l'état de l'option.

VERSION REVISEE DES OPTIONS A COCHER TTK. 

Le module d'extension tkinter.ttk propose une version révisée du options à choix. L'aspect des objets de la classe tkinter.ttk.Checkbutton ( ) est confié à l'attribut style. De ce fait seuls les attributs qui personnalisent réellement une option à choix restent disponibles. Pour plus de détails, voir :

- les boutons cliquables révisés tkinter.ttk.Checkbutton ( ) ;

- le module d'extension tkinter.ttk ;

- la classe tkinter.ttk.Style ( ).