DESCRIPTION.

Retourne un tuple ( ) de 2 éléments délimitant la portion visible d'un objet tkinter.ttk.Treeview ( ).

SYNTAXE.

TPL_Visible = TRV_Tableau.xview ( )

TPL_Visible = ⇨ variable qui recevra la valeur [ optionnel ]

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

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

TRV_Tableau.xview ( abscisse )

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

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

abscisse ⇨ abscisse du pixel [ optionnel ]

REMARQUES.

Utilisée avec le paramètre abscisse : 

La méthode tkinter.ttk.Treeview ( ).xview ( ) déplace le contenu de l’arborescence pour que le pixel abscisse soit sur le bord gauche de la zone de visibilité du controle.

Utilisée sans le paramètre abscisse : 

La méthode tkinter.ttk.Treeview ( ).xview ( ) retourne deux float ( ) compris entre 0.0 et 1.0, où : 

- 0.0 représente la bordure gauche de l'arborescence ;

- 1.0 représente la bordure droite de l'arborescence.

L'intervalle (0, 1) représente la longueur total de l'arborescence. Les 2 éléments du tuple ( ) désignent donc les 2 positions relatives, de début et de fin, de l'intervalle de la partie de actuellement visible de l'arborescence.  La partie de l'arborescence comprise entre : 

- 0.0 et le premier élément du tuple ( ) est partie cachée à gauche de la partie actuellement visible ;

- les deux éléments du tuple ( ) est la partie du contenu actuellement visible ;

- le deuxième élément du tuple ( ) et 1.0 est partie cachée à droite de la partie actuellement visible.

L'intervalle décrit, par le tuple ( ) retourné, se rapporte à la partie du contenu actuellement visible.

Si le contenu de l'arborescence est entièrement visible, le tuple ( ) retourné est ( 0.0 , 1.0 ) c'est-à-dire 100% du contenu.

Les valeurs contenues dans le tuple ( ), retournées par la méthode tkinter.ttk.Treeview ( ).xview ( ), seront transmises à la barre de d’ascenseur horizontale liée à l'arborescence via : 

- l'attribut xcrollcommand de l'arborescence ;

- l'attribut command de la barre de d’ascenseur.

Note. Pour gérer au mieux les dimensions, il préférable de disposer une arborescence, surtout si elle doit avoir plusieurs colonnes, dans un conteneur, avec ou sans titre, et d'utiliser le gestionnaire de placement tkinter.place ( ) pour le déposer dans ce conteneur. Comme il est alors probable que seule une partie du tableau sera alors visible, on pourra, devra, associer le tableau à des barres de défilement et les mettre, elles aussi, dans le conteneur parent du tableau. Voir dimensionner une arborescence et lui associer des assesseurs dans le tutoriel des arborescence.

EXEMPLE.

import tkinter , tkinter.ttk

def FNC_Go ( event ) : 

TRV_Eleves.xview ( event )

kratio = TRV_Eleves.xview ( )

LAB_Ratio [ "text" ] = f"TRV_Eleves.xview ( ) retourne\n( { kratio [ 0 ] } , { kratio [ 1 ] } )."

TKI_Principal = tkinter.Tk ( )

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

SCA_Abscisse = tkinter.Scale ( TKI_Principal , orient = "horizontal" , to = 750 , command = FNC_Go )

LAB_Ratio = tkinter.Label ( TKI_Principal )

FRM_Tableau = tkinter.Frame ( TKI_Principal , bd = 2 , relief = "ridge" , width = 300 , height = 200 )

TRV_Eleves = tkinter.ttk.Treeview ( FRM_Tableau , columns =  ( "a" , "b" , "c" , "d" , "e" , "f" ) )

TRV_Eleves.place ( x = 5 , y = 5 , width = 290 , height = 190 )

TRV_Eleves.heading ( "#0" , text = "Nom" )

for knote in ( "abcdef" ) :

TRV_Eleves.heading ( knote , text = knote.upper ( ) )

TRV_Eleves.column ( knote , width = 100 )

for keleve in range ( 30 ) : TRV_Eleves.insert ( "" , "end" , keleve , text = f"Eleve { keleve } ..." )

FRM_Tableau.pack ( )

SCA_Abscisse.pack ( )

LAB_Ratio.pack ( )

BUT_Quitter.pack ( )

FNC_Go ( 0 ) 

TKI_Principal.mainloop ( )