DESCRIPTION.

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

SYNTAXE.

widget.columnconfigure ( colonne , attribut1 = valeur , ... , attributn = valeur )

widget ⇨ controle quelconque de l'interface [ OBLIGATOIRE ]

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

colonne ⇨ colonne à configurer [ OBLIGATOIRE ]

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

REMARQUES.

colonne peut être : 

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

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

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

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

Si colonne est le seul argument de l'appel, tkinter.columnconfigure ( ), retourne la configuration actuelle de colonne dans un dict ( ). colonne peut se référer à une colonne non visible, non utilisée ou pas encore créée. Rappel : La première colonne, 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 COLUMNCONFIGURE. 

minsize = pixels, 

pixels est un int ( ) imposant une taille minimum, en pixels, à la colonne. Si la colonne 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, à droite et à gauche, à la taille du plus large des controles dans la colonne.

uniform = identifiant

identifiant est un int ( ), un str ( ) ou None. Toutes les colonnes 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 colonne occupera sur la longueur total de la ligne. Si weight n'est pas présent, la colonne n'est pas étirable. Si weight est identique pour toutes les colonnes d'une même ligne, elles auront toutes la même longueur. Par exemple si le poids total d'une ligne est de ( 9 + 3 + 7 + 0 + 6 = ) 25 et si :

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

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

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

widget.columnconfigure ( 3 ), la colonne 3 n'est pas étirable, sa longueur ne pourra pas être modifiée ;

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

EXEMPLE.

import tkinter

LST_Minimums = [ ]

LST_Marges = [ ]

LST_Ratios = [ ]

def FNC_Modifier ( event ) :

for kcolonne in range ( 5 ) :

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

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

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

TKI_Principal.columnconfigure ( kcolonne , minsize = kminimum , pad = kmarge , weight = kratio )

TKI_Principal = tkinter.Tk ( )

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

for kcolonne in range ( 5 ) :

kposition = f"Colonne : { kcolonne }"

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

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

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

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

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

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

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

LST_Minimums.append ( kminimum )

LST_Marges.append ( kmarge )

LST_Ratios.append (  kratio )

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

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

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

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

TKI_Principal.mainloop ( )