DESCRIPTION.

Ajoute une suite options, sous la forme d'un menu déroulant, à un choix présent dans un menu déroulant.

SYNTAXE.

MNU_Choix.add_cascade ( attribut1 = valeur , ... , attributn = valeur )

MNU_Choix ⇨ instance quelconque de tkinter.Menu ( ) [ OBLIGATOIRE ]

.add_cascade ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

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

REMARQUES.

La méthode tkinter.Menu ( ).add_cascade ( ) associe un menu déroulant, le menu-enfant, à un choix dans un autre menu déroulant, le menu-parent, grâce à l'attribut menu du menu-parent. Si l'attribut menu est omis dans l'appel de la méthode, le choix se terminera aussi par une marque mais ne développera aucun menu-enfant. Le menu-enfant, qui sera imbriqué dans le menu-parent, doit être créé avant son association au choix qui l'ouvrira dans le menu-parent.

La méthode tkinter.Menu ( ).add_cascade ( ) devra aussi être utilisée pour placer les menus déroulants dans les onglets d'une barre de menu d'une fenêtre. 

La méthode tkinter.Menu ( ).add_cascade ( ) correspond à tkinter.Menu ( ).add ( "cascade" ). 

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.

menu = MNU_parent

Cet attribut n'est utilisé qu'avec le type "cascade", il indique quel menu déroulant sera le conteneur du sous-menu, par exemple : MNU_Enfant.add ( "cascade" , menu = MNU_Parent ) ajoute un sous-menu déroulant nommé MNU_Enfant dans le menu MNU_Parent nommée. Ensuite les choix proposés dans le sous-menu enfant se feront comme suit : MNU_Enfant.add ( type , attribut1 = valeur , ... , attributn = valeur ).

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.

EXEMPLE.

import tkinter

TKI_Principal = tkinter.Tk ( )

# --- Création d'une barre de menu dans une fenêtre ---

MNU_Menu = tkinter.Menu ( TKI_Principal )

# --- Création du premier onglet de la barre de menu ---

MNU_Choix = tkinter.Menu ( MNU_Menu ) 

MNU_Choix.add_command ( label = "Choix 1" ) 

MNU_Choix.add_command ( label = "Choix 2" ) 

# --- Création d'un sous menu dans le premier onglet ---

MNU_Choix_3 = tkinter.Menu ( MNU_Menu ) 

MNU_Choix_3.add_command ( label = "Choix 3a" ) 

MNU_Choix_3.add_command ( label = "Choix 3b" ) 

MNU_Choix_3.add_command ( label = "Choix 3c" ) 

MNU_Choix_3.add_command ( label = "Choix 3d" ) 

# --- Mise en place du sous-menu dans le premier onglet ---

MNU_Choix.add_cascade ( menu = MNU_Choix_3 , label = "Choix 3 : ... " )

# --- Suite des choix du premier onglet ---

MNU_Choix.add_command ( label = "Choix 4" )

MNU_Choix.add_command ( label = "Choix 5" )

# --- Création d'un autre sous menu dans le premier onglet ---

MNU_Choix_6 = tkinter.Menu ( MNU_Menu ) 

MNU_Choix_6.add_command ( label = "Choix 6a" ) 

MNU_Choix_6.add_command ( label = "Choix 6b" ) 

# --- Mise en place du sous-menu dans le premier onglet ---

MNU_Choix.add_cascade ( menu = MNU_Choix_6 , label = "Choix 6 : ... " )

# --- Création d'un autre sous menu dans le premier onglet ---

MNU_Choix_7 = tkinter.Menu ( MNU_Menu ) 

MNU_Choix_7.add_command ( label = "Choix 7a" ) 

MNU_Choix_7.add_command ( label = "Choix 7b" )

# --- Création d'un sous menu imbriqué dans un sous menu ---

MNU_Choix_7c = tkinter.Menu ( MNU_Menu ) 

MNU_Choix_7c.add_command ( label = "Choix 7c +" ) 

MNU_Choix_7c.add_command ( label = "Choix 7c ++" )

MNU_Choix_7c.add_command ( label = "Choix 7c +++" )

MNU_Choix_7c.add_command ( label = "Choix 7c ++++" )

# --- Mise en place du sous-menu imbriqué dans son sous menu parent ---

MNU_Choix_7.add_cascade ( menu = MNU_Choix_7c , label = "Choix 7c : ... " )

# --- Suite des choix du sous menu  ---

MNU_Choix_7.add_command ( label = "Choix 7d" ) 

MNU_Choix_7.add_command ( label = "Choix 7e" )

# --- Mise en place du sous-menu et de son sous menu imbriqué ---

MNU_Choix.add_cascade ( menu = MNU_Choix_7 , label = "Choix 7 : ... " )

# --- Suite des choix du  premier onglet ---

MNU_Choix.add_command ( label = "Choix 8" )

MNU_Choix.add_command ( label = "Choix 9" )

# --- Création d'un autre onglet de la barre de menu ---

MNU_Quitter = tkinter.Menu ( MNU_Menu )

MNU_Quitter.add_command ( label = "Quitter" , command = TKI_Principal.destroy )

# --- Mise en place des ongles dans la barre de menu ---

MNU_Menu.add_cascade ( menu = MNU_Choix , label = "Options" )

MNU_Menu.add_cascade ( menu = MNU_Quitter , label = "Quitter" )

# --- Mise en place de la barre de menu dans la fenêtre ---

TKI_Principal [ "menu" ] = MNU_Menu

TKI_Principal.mainloop ( )