⇨ MENU ⇨ MODULES ⇨ tkinter ⇨ controles standards ⇨ Menu
tkinter.Menu ( ).insert_checkbutton ( )
⇨ MENU ⇨ MODULES ⇨ tkinter ⇨ controles standards ⇨ Menu
tkinter.Menu ( ).insert_checkbutton ( )
DESCRIPTION.
Insert un choix avec une option à cocher dans un menu déroulant.
SYNTAXE.
MNU_Choix.insert_checkbutton ( index , attribut1 = valeur , ... , attributn = valeur )
MNU_Choix ⇨ instance quelconque de tkinter.Menu ( ) [ OBLIGATOIRE ]
.insert_checkbutton ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]
index ⇨ index du choix [ OBLIGATOIRE ]
attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]
REMARQUES.
index est un int ( ) ou l'un des str ( ) d'index spécifiques indiquant l'index du choix dans le menu déroulant.
Les index spécifiques sont des constantes exprimées sous la forme d'un str ( ) et peuvent prendre l'une des valeurs suivantes :
- "active" pour le choix du menu déroulant actif au moment de l'appel ;
- "end" pour le dernier choix du menu déroulant, identique à "last" ;
- "last" pour le dernier choix du menu déroulant, identique à "end" ;
- "@y" qui correspond au choix du menu déroulant le plus proche de la ligne à ordonnées y.
Rappel : l'index du premier choix d'un menu déroulant est 0.
La méthode tkinter.Menu ( ).insert_checkbutton ( ) permet de présenter à l'utilisateur des options à valider ou à retirer.
Si plusieurs choix, sous la forme de cases à cocher, sont associées à la même variable de controle, le fait d'agir sur l'une d'elles, désélectionne toutes les autres. Cette technique est à proscrire, dans ce cas, on lui préférera la méthode tkinter.Menu ( ).add_radiobutton ( ) qui n'autorise qu'un choix dans groupe d'options associées à la même variable de controle.
LISTE DES ATTRIBUTS DES CHOIX.
accelerator = chaine
Affiche à droite du choix, la touche, ou la combinaison de touches, informant du raccourcis clavier associé au choix. Attention : chaine n'est pas géré automatiquement, le script devra prévoir un gestionnaire d'événement déclenché par la combinaison de chaine au claver et invoquant la même action que celle affecté à l'attribut command du choix.
activebackground = couleur
Couleur de fond du choix lorsque le pointeur de la souris est sur lui.
activeborderwidth = taille
Épaisseur, en pixels, de la bordure du choix lorsque le pointeur de la souris est sur lui.
activeforeground = couleur
Couleur de texte du choix lorsque le pointeur de la souris est sur lui.
background = couleur ou bg = couleur
Couleur de fond du choix.
bitmap = image
Image bitmap à afficher. Si cet attribut est spécifié, il remplace l'attribut label. pour associer une image à une étiquette, on utilisera plutot les attribut image, label et compound. Lattriut bitmap n'est pas disponible pour "separator" et la ligne de détachement.
borderwidth = taille ou bd = taille
Épaisseur, en pixels, de la bordure du choix.
columnbreak = booleen
Si booleen vaut False le choix sera aligné avec le précédent. Si booleen vaut True il sera décalé sur la droite.
command = fonction
Fonction à invoquer quand l'utilisateur clique, et confirme en relachant le bouton gauche, sur le choix.
compound = position
Positionne de l'image par rapport au texte du choix. Les positions valides sont : "bottom", "center", "left", "right" et "top".
font = style
Définit les caractéristiques des caractères du texte.
foreground = couleur ou fg = couleur
Couleur de texte du choix.
hidemargin = booleen
Si booleen vaut True l'espace séparant deux choix est supprimé. Si booleen vaut False l'espace est rétabli.
image : image
Image à afficher en association avec le texte. image doit être un objet de type tkinter.PhotoImage ( ). l'utilisation de l'attribut compound permet de positionner l'image par rapport au texte.
label = chaine
Texte à afficher pour dérire le choix. chaine doit être un str ( ) valide.
offvalue = valeur
Valeur à affecter à la variable de controle associée au choix quand la case est décochée.
onvalue = valeur
Valeur à affecter à la variable de controle associée au choix quand la case est cochée.
selectcolor = couleur
Définit la couleur de fond de la case associée au choix.
selectimage : image
Indique l'image à afficher quand le choix est activé, coché.
state = etat
Définit l'état du controle. etat peut être : "active", "disabled", et "normal".
underline = chaine
Indique quel caractère du texte sera souligné, informant l'utilisateur du raccourcis clavier associé au choix. Attention : chaine n'est pas géré automatiquement, le script devra prévoir un gestionnaire d'événement déclenché par l’appui sur la touche du claver et invoquant la même action que celle affecté à l'attribut command du choix.
variable = TKV_Variable
Définit quelle variable de controle sera associée au choix.
EXEMPLE.
import tkinter
def FNC_Inserer ( ) :
kindex = MNU_Choix.index ( "end" ) - 1
MNU_Choix.insert_checkbutton ( kindex , label = f"Paramètre à cocher : { kindex - 1 }" )
TKI_Principal = tkinter.Tk ( )
MNU_Menu = tkinter.Menu ( TKI_Principal )
MNU_Choix = tkinter.Menu ( MNU_Menu )
MNU_Choix.add_command ( label = "Insérer une coche ... " , command = FNC_Inserer )
MNU_Choix.add_separator ( )
MNU_Choix.add_command ( label = "Quitter" , command = TKI_Principal.destroy )
MNU_Menu.add_cascade ( menu = MNU_Choix , label = "Test insertion" )
TKI_Principal [ "menu" ] = MNU_Menu
tkinter.Label ( TKI_Principal , text = "Mon Python A Moi." , bg = "white" ).pack ( )
TKI_Principal.mainloop ( )
Votre aide est précieuse pour améliorer ce site, alors n'hésitez pas à faire part de