DESCRIPTION.

Configure une ligne du gestionnaire de placement tkinter.grid ( ), ou retourne sa configuration.

SYNTAXE.

widget.rowconfigure ( ligne , attribut1 = valeur , ... , attributn = valeur )

widget ⇨ controle quelconque de l'interface [ OBLIGATOIRE ]

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

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

REMARQUES.

ligne peut être : 

- un int ( ) identifiant une ligne définit avec le gestionnaire de placement tkinter.grid ( ) ;

- une list ( ) identifiant toutes les lignes à modifier ;

- le nom d'un conteneur qui appliquera les modifications à toutes ses lignes ;

- "all" pour appliquer les modifications à toutes les lignes de tous les conteneurs de l'interface.

Si ligne est le seul argument de l'appel, tkinter.rowconfigure ( ), retourne la configuration actuelle de ligne dans un dict ( ). ligne peut se référer à une ligne non visible, non utilisée ou pas encore créée. Rappel : La première ligne, la plus à gauche, à le numéro 0.

Par convention, on utilise le conteneur accueillant le gestionnaire de placement tkinter.grid ( ) pour l'utilisation de cette méthode. 

LISTE DES ATTRIBUTS DE ROWCONFIGURE. 

minsize = pixels

pixels est un int ( ) imposant une taille minimum, en pixels, à la ligne. Si la ligne ne contient aucun controle, elle n’apparait pas, même si  minsize = pixels précise une taille minimale.

pad = pixels

pixels est un int ( ) indiquant le nombre de pixels à ajouter comme marge, au dessus et au dessous, à la taille du plus haut des controles dans la ligne.

uniform = identifiant

identifiant est un int ( ), un str ( ) ou None. Toutes les lignes ayant le même identifiant, s'il est différent de None, appartiennent au même groupe, et leurs tailles sont allouées de façon qu'elles soient constamment proportionnelles à la valeur de leurs ratio. 

weight = quota

quota est un int ( ) indiquant la proportion d'espace que la ligne occupera sur la hauteur total de la colonne. Si ratio n'est pas présent, la ligne n'est pas étirable. Si quota est identique pour toutes les lignes d'une même colonne, elles auront toutes la même hauteur. Par exemple si le poids total d'une colonne est de ( 9 + 3 + 7 + 0 + 6 = ) 25 et si :

widget.rowconfigure ( 0 , weight = 9 ), la ligne 0 s'étirera est prendra 36 % (9/25) de la hauteur total de la colonne ;

widget.rowconfigure ( 1 , weight = 3 ), la ligne 1 s'étirera est prendra 12 % (3/25) de la hauteur total de la colonne ;

widget.rowconfigure ( 2 , weight = 7 ), la ligne 2 s'étirera est prendra 28 % (7/25) de la hauteur total de la colonne ;

widget.rowconfigure ( 3 ), la ligne 3 n'est pas étirable, sa hauteur ne pourra pas être modifiée ;

widget.rowconfigure ( 4 , weight = 6 ), la ligne 4 s'étirera est prendra 24 % (6/25) de la hauteur total de la colonne.

EXEMPLE.

import tkinter

LST_Minimums = [ ]

LST_Marges = [ ]

LST_Ratios = [ ]

def FNC_Modifier ( event ) :

for kligne in range ( 5 ) :

kminimum = int ( LST_Minimums [ kligne ].get ( ) )

kmarge = int ( LST_Marges [ kligne ].get ( ) )

kratio = int ( LST_Ratios [ kligne ].get ( ) )

TKI_Principal.rowconfigure ( kligne , minsize = kminimum , pad = kmarge , weight = kratio )

TKI_Principal = tkinter.Tk ( )

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

for kligne in range ( 5 ) :

kposition = f"Ligne : { kligne }"

tkinter.Label ( TKI_Principal , text = kposition , relief = "solid" ).grid ( row = kligne , column = 0 , sticky = "nesw" )

kminimum = tkinter.Scale ( TKI_Principal , from_= 50 , to = 100 , orient = "horizontal" , command = FNC_Modifier )

kmarge = tkinter.Scale ( TKI_Principal , from_= 0 , to = 50 , orient = "horizontal" , command = FNC_Modifier )

kratio = tkinter.Scale ( TKI_Principal , from_= 0 , to = 25 , orient = "horizontal" , command = FNC_Modifier )

kminimum.grid ( row = kligne , column = 1 , sticky = "nesw" )

kmarge.grid ( row = kligne , column = 2 , sticky = "nesw" )

kratio.grid ( row = kligne , column = 3 , sticky = "nesw" )

LST_Minimums.append ( kminimum )

LST_Marges.append ( kmarge )

LST_Ratios.append (  kratio )

tkinter.Label ( TKI_Principal , text = "minisize" , anchor = "w" ).grid ( row = 5 , column = 1 )

tkinter.Label ( TKI_Principal , text = "pad" , anchor = "w" ).grid ( row = 5 , column = 2 )

tkinter.Label ( TKI_Principal , text = "weight" , anchor = "w" ).grid ( row = 5 , column = 3 )

BUT_Quitter.grid ( row = 0 , column = 6 , rowspan = 6 , sticky = "nesw" )

TKI_Principal.mainloop ( )