DESCRIPTION.

Créer une nouvelle arborescence graphique d'éléments avec présentation possible en tableau (widget : tkinter.ttk.Treeview ( )).

SYNTAXE.

TRV_Tableau = tkinter.ttk.Treeview ( parent , attribut1 = valeur , ... , attributn = valeur )

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

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

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

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

CREATION DES ARBORESCENCES ET TABLEAUX.

La classe tkinter.ttk.Treeview ( ) n'est pas native du module tkinter, il faut donc commencer par importer le module d'extension tkinter.ttk pour pouvoir utiliser cette classe. Voir import pour plus de détails sur l'incorporation de modules, classes et méthodes non built-in dans un script.

Voir le tutoriel sur les arborescences ou tableaux d'éléments ...

STYLES DES ARBORESCENCES ET TABLEAUX.

"." : style par défaut de la racine du style.

"Cell" : style par défaut des cellules des arborescences.

"Heading" : style par défaut de la ligne d'entête des arborescences.

"Item" : style par défaut des éléments des arborescences.

"Treeview" : style par défaut de conteneur des arborescences.

ETATS DYNAMIQUES DES ARBORESCENCES ET TABLEAUX.

"disabled" : l'arborescence est insensible aux actions l'utilisateur.

"selected" : l'arborescence est sélectionnée.

LISTE DES ATTRIBUTS ARBORESCENCES ET TABLEAUX.

class : référence des valeurs des attributs dans la base de données.

columns : définit le nombre de colonnes et leur identifiants.

cursor : défini l'aspect du pointeur de la souris lorsqu'il se trouve sur le controle.

displaycolumns : identifiants des colonnes à afficher et leur ordonnancement.

height : hauteur du controle.

padding : marges à l'intérieur du controle.

selectmode : mode de sélection des éléments : “extended” par défaut, “browse” ou “none”.

show : défini les éléments de présentation à afficher dans le controle. 

state : modifie l'état du controle.

style : associe un style au controle.

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

xscrollcommand : positionnement précis de l'ascenseur horizontal.

yscrollcommand : positionnement précis de l'ascenseur vertical.

Voir aussi la classe tkinter.ttk.Style ( ) et les attributs accessibles uniquement par cette classe. 

MÉTHODES SPÉCIFIQUES DES ARBORESCENCES ET TABLEAUX.

bbox ( ) : retourne la boite englobante d'un l'élément de l'arborescence.

column ( ) : configure les colonnes de l'arborescence.

delete ( ) : supprime des éléments de l'arborescence.

detach ( ) : cache des éléments de l'arborescence.

exists ( ) : retourne True si l'élément existe dans l'arborescence.

focus ( ) : donne le focus à un l'élément de l'arborescence.

get_children ( ) : retourne la liste des enfants d'un l'élément.

heading ( ) : configure les étiquettes des colonnes. 

identify ( ) : retourne une description de la zone aux coordonnées précisées.

identify_column ( ) : retourne le rang de la colonne à l'abscisse précisée.

identify_element ( ) : retourne le composant de l'arborescence aux coordonnées précisées.

identify_region ( ) : retourne la partie de l'arborescence aux coordonnées précisées.

identify_row ( ) : retourne l'identifiant de l'élément de l'arborescence à l'ordonnée précisée

index ( ) : retourne l'index d'un élément dans sa parenté.

insert ( ) : ajoute un nouvel élément dans l'arborescence.

item ( ) : modifie les valeurs des attributs d'un élément de l'arborescence.

move ( ) : déplace un élément dans l'arborescence.

next ( ) : retourne l'élément suivant dans l'arborescence.

parent ( ) : retourne le parent d'un élément dans l'arborescence.

prev ( ) : retourne l'élément précédent dans l'arborescence.

reattach ( ) : Idem move ( ).

see ( ) : place l'élément de tel sorte qu'il soit visible dans l'arborescence.

selection ( ) : retourne les éléments sélectionnés dans l'arborescence.

selection_add ( ) : ajoute des éléments à la sélection d'une arborescence.

selection_remove ( ) : retire des éléments de la sélection d'une arborescence.

selection_set ( ) : définit les éléments de la sélection d'une arborescence.

selection_toggle ( ) : inverse l'état de la sélection d'une arborescence.

set ( ) : modifie la donnée d'une colonne d'un élément d'une arborescence.

set_children ( ) : remplace les enfants d'un élément d'une arborescence.

tag_bind ( ) : lie un gestionnaire d'événement à une balise d'une arborescence.

tag_configure ( ) : modifie les valeurs des attributs des éléments associés à une balise.

tag_has ( ) : retourne les éléments associés à une balise de l'arborescence.

xview ( ) : retourne ou modifie la portion horizontale visible de l'arborescence.

xview_moveto ( ) : modifie l'abscisse, relative, du bord gauche de la zone visible.

xview_scroll ( ) : fait défiler horizontalement le contenu dans le controle.

yview ( ) : retourne ou modifie la portion verticale visible de l'arborescence.

yview_moveto ( ) : modifie l'ordonnée, relative, du bord haut de la zone visible.

yview_scroll ( ) : fait défiler verticalement le contenu dans le controle.

EVENEMENT SPECIFIQUE  DES ARBORESCENCES ET TABLEAUX.

 "<<TreeviewClose>>" : la descendance de l'élément vient d'être cachée.

 "<<TreeviewOpen>>" : la descendance de l'élément vient d'être affichée.

 "<<TreeviewSelect>>" : la sélection à été modifiée.