DESCRIPTION.

Force la fenêtre principale à être gérée comme une grille pour le placement de ses enfants.

SYNTAXE.

TKI_Fenetre.grid ( largeur , hauteur , colonne , ligne )

TKI_Fenetre ⇨ instance quelconque de tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

largeur ⇨ largeur maximum de la grille en pixels [ OBLIGATOIRE ]

hauteur ⇨ hauteur maximum de la grille en pixels [ OBLIGATOIRE ]

colonne ⇨ largeur maximum des colonnes en pixels [ OBLIGATOIRE ]

ligne ⇨ hauteur maximum des ligne en pixels [ OBLIGATOIRE ]

ou 

TKI_Fenetre.wm_grid ( largeur , hauteur , colonne , ligne )

TKI_Fenetre ⇨ instance quelconque de tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

largeur ⇨ largeur maximum de la grille en pixels [ OBLIGATOIRE ]

hauteur ⇨ hauteur maximum de la grille en pixels [ OBLIGATOIRE ]

colonne ⇨ largeur maximum des colonnes en pixels [ OBLIGATOIRE ]

ligne ⇨ hauteur maximum des ligne en pixels [ OBLIGATOIRE ]

REMARQUES.

Attention à ne pas confondre cette méthode avec la méthode générale tkinter.grid ( ), qui permet de gérer le gestionnaire de placement des controles dans une grille. Surtout que la méthode tkinter.Toplevel.grid ( ) ne doit être appelée que très exceptionnellement. En effet; il est préférable, plus simple et plus prudent d'utiliser les propriétés offertes par le gestionnaire de placement et accessibles avec la méthode générale tkinter.grid ( ).

largeur est un argument nommé et doit avoir la forme baseWidth = valeur, où valeur être un int ( ) non négatif.

hauteur est un argument nommé et doit avoir la forme baseHeight = valeur, où valeur être un int ( ) non négatif.

colonne est un argument nommé et doit avoir la forme widthInc = valeur, où valeur être un int ( ) non négatif.

ligne est un argument nommé et doit avoir la forme heightInc = valeur, où valeur être un int ( ) non négatif.

L'ordre des arguments n'est pas fixé, ils peuvent être placées selon les gouts du programmeur, mais ils doivent tous être présents dans l'appel de la méthode  tkinter.Toplevel.grid ( ).

La méthode tkinter.Toplevel.grid ( ) indique que la fenêtre doit être gérée comme une fenêtre quadrillée, c'est_à-dire comme une grille. Elle donne aussi les spécifications de la relation entre les unités de grille et les unités de pixel.

largeur et hauteur spécifient le nombre d'unités de grille correspondant aux dimensions en pixels demandées en interne par la fenêtre à l'aide de Tk_GeometryRequest. Alors que colonne et ligne spécifient le nombre de pixels dans chaque unité de grille horizontale et verticale. De fait largeur , hauteur , colonne , ligne déterminent une plage de tailles acceptables pour la fenêtre, correspondant aux largeurs et hauteurs basées sur la grille qui sont des entiers non négatifs.

La fenêtre principale transmettra ces informations au gestionnaire de fenêtres ; lors du redimensionnement manuel, le gestionnaire de fenêtres limitera la taille de la fenêtre à l'une de ces tailles acceptables. De plus, lors du redimensionnement manuel, le gestionnaire de fenêtres affichera la taille actuelle de la fenêtre en termes d'unités de grille plutôt qu'en pixels.

Pour annuler la gestion de la fenêtre comme une grille, il faut affecter une chane vide ("") comme valeur, à tous les arguments. L'appel aura alors la forme TKI_Fenetre.grid ( baseWidth = "" , baseHeight = "" , widthInc = "" , heightInc = "" ).

Utilisée sans argumnts, la méthode tkinter.Toplevel.grid ( ) retourne : 

- un tuple ( ) indiquant les valeurs des arguments baseWidth, baseHeight, widthInc, heightInc ; toujours dans cet ordre ;

- ou None si la fenêtre n'est pas gérée comme une grille.

La forme TKI_Fenetre.wm_grid ( ) appelle la méthode wm_grid ( ) héritée de la classe tkinter.Wm ( ), le window manager de tkinter, qui gère la communication avec le gestionnaire de fenêtres de l'OS présent sur la machine accueillant le programme.

EXEMPLE.

import tkinter

TKI_Principal = tkinter.Tk ( )

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

TKI_Test = tkinter.Toplevel ( )

TKI_Test.geometry ( "+250+150" )

TKI_Test.grid ( baseWidth = 199 ,  widthInc = 10 , baseHeight = 30 , heightInc = 25 )

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

TKI_Principal.mainloop ( )