DESCRIPTION.

Ajoute un nouvel élément dans un objet tkinter.ttk.Treeview ( ).

SYNTAXE.

TRV_Tableau.insert ( parent , index , identifiant , attribut1 = valeur , ... , attributn = valeur )

TRV_Tableau ⇨ instance de tkinter.ttk.Treeview ( ) [ OBLIGATOIRE ]

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

parent ⇨ parent du nouvel élément [ OBLIGATOIRE ]

index ⇨ position dans l’affiliation [ OBLIGATOIRE ]

identifiant ⇨ identifiant de l'élément [ OBLIGATOIRE ]

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

REMARQUES.

parent est un str ( ) désignant l'identifiant d'un élément de l'arborescence qui sera le noeud interne qui contiendra le nouvel élément. L'identifiant d'un élément, sauf pour l'ancêtre, est la chaine de caractères donnée en troisième argument dans la méthode tkinter.ttk.Treeview ( ).insert ( ). L’ancêtre de tous les parents est identifié par un str ( ) vide : "".Si parent n'existe pas, ou n'existe plus, Python lèvera une exception.

index est : 

- 0, le nouvel élément sera placé en premier dans la liste des enfants de parent , ou ;

- un int ( ) indiquant la position précise, dans la hiérarchie des enfants, du nouvel élément, ou ;

- "end", le nouvel élément sera placé en dernier dans la liste des enfants.

A noter : La position d'un élément n'est pas définitive et invariable. Cette position peut varier lors de l'ajout, la destruction, le détachement, le déplacement d'autres éléments.

identifiant est un str ( ) quelconque mais valide. identifiant doit être unique. Si un autre élément a déjà été créé avec cette valeur, Python lèvera une exception.

LISTE DES ATTRIBUTS DES ELEMENTS. 

image = image

Image à placer à la gauche du texte de l'étiquette. image doit être dans un format autorisé dans tkinter.

open = booleen

Si booleen vaut True la liste des enfants de l'élément sera développée. Sinon elle sera cachée tant que l'utilisateur ne l'affichera pas.

tags = secquence

secquence est un tuple ( ) contenant toutes les balises associées à l'élément. Une balise est un str ( ) choisi librement. Tous les éléments associés par la même balise font partie d'un groupe. Il adopteront tous le même aspect et/ou comportement. Si l'élément n'est associé qu'à une seul balise, secquence peut alors être un str ( ). 

text = chaine

Texte de l'étiquette. chaine doit être un str ( ) quelconque mais valide.

values = secquence

secquence est un tuple ( ) contenant toutes données à afficher, dans une cellule du tableau, à droite de l'étiquette. Chaque éléments du tuple ( ) doit correspondre à l'une des colonnes définies avec l'attribut columns lors de la création de l'arborescence.

EXEMPLE.

import tkinter , tkinter.ttk

TKI_Principal = tkinter.Tk ( )

TRV_Pays = tkinter.ttk.Treeview ( TKI_Principal )

TRV_Pays.heading ( "#0" , text = "Pays" )

TRV_Pays.insert ( "" , "end" , "ca" , text = "Canada" , tags = ( "canada" , ) )

TRV_Pays.insert ( "" , "end" , "su" , text = "Suisse" )

TRV_Pays.insert ( "" , "end" , "ue" , text = "Union Européenne" , open = True )

TRV_Pays.insert ( "" , "end" , "an" , text = "Andorre" )

TRV_Pays.insert ( "" , "end" , "al" , text = "Algerie" )

TRV_Pays.insert ( "" , "end" , "ma" , text = "Maroc" )

TRV_Pays.insert ( "" , "end" , "li" , text = "Liban" )

TRV_Pays.insert ( "ue" , "end" , "ue.be" , text = "Belgique" , tags = "belgique" )

TRV_Pays.insert ( "ue" , "end" , "ue.fr" , text = "France" )

TRV_Pays.insert ( "ue" , "end" , "ue.lu" , text = "Luxembourg" )

TRV_Pays.tag_configure ( "canada" , foreground = "white" , background = "red" )

TRV_Pays.tag_configure ( "belgique" , foreground = "red" , background = "yellow" )

TRV_Pays.pack ( )

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

TKI_Principal.mainloop ( )