DESCRIPTION.

Ajoute un controle dans un bandeau de controles.

SYNTAXE.

FRM_Bandeau.add ( enfant , attribut1 = valeur , ... , attributn = valeur )

FRM_Bandeau ⇨ instance de tkinter.PanedWindow ( ) [ OBLIGATOIRE ]

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

enfant ⇨ controle à ajouter [ OBLIGATOIRE ]

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

REMARQUES.

enfant doit être l'identifiant, le chemin ou une variable désignant un controle valide et existant.

Par défaut, les controles sont ajouter en dernière position dans le bandeau, et ils remplissent tout l'espace disponible dans leur cellule.

Bien que cela soit vivement déconseillé, le controle accueillie dans une cellule, d'un bandeau de controle, peut être créer lors l'appel de la méthode tkinter.PanedWindow ( ).add ( ). Dans ce cas, il n'est pas utile d'indiquer le parent, conteneur, du controle qui est le bandeau de controles lui-même.

LISTE DES ATTRIBUTS D'INSERTION. 

after = controle

Indique après quel autre enfant du bandeau de controles il faut placer enfant. 

before = controle

Indique avant quel autre enfant du bandeau de controles il faut placer enfant. 

height = taille

Hauteur, en pixels, de la cellule contenant enfant.

hide = booleen

Si hide = True, la cellule est cachée mais enfant reste présent dans la liste des controle. Si hide = False, la cellule sera visible. 

minsize = taille

Taille minimale, en pixels, que pourra prendre le controle, dans le sens défini par l'attribut orient. du bandeau de controles.

padx = taille

Marge supplémentaire à gauche et à droite de enfant.

pady = taille

Marge supplémentaire au dessus et en dessous de enfant.

sticky = ancre

Gestion de l'espace non occupé par enfant dans la cellule. ancre doit avoir l'une des valeur suivantes : "", "n", "ne", "e", "se", "s", "sw", "w", "nw", "ns", "ew", "nse", "nsw", "ewn", "ews", "nesw".

stretch = mode

Indique quand la cellule contenant enfant pourra se redimensionner. mode doit avoir l'une des valeur suivantes : 

- "always", la cellule contenant enfant se redimensionne toujours ;

- "first", la cellule contenant enfant se redimensionne uniquement si elle est en première position ;

- "last", la cellule contenant enfant se redimensionne uniquement si elle est en dernière position ;

- "midle", la cellule contenant enfant se redimensionne si elle n'est pas à une extrémité du bandeau ;

- "never", la cellule contenant enfant se redimensionne jamais.

width = taille

Largeur, en pixels, de la cellule contenant enfant.

EXEMPLE.

1. Création des controles à insérer à la volet.

import tkinter 

TKI_Principal = tkinter.Tk ( )

FRM_Bandeau = tkinter.PanedWindow ( TKI_Principal , orient = "horizontal" , sashrelief = "solid" )

for kcase in range ( 5 ) : FRM_Bandeau.add ( tkinter.Label ( text = f" case : { kcase }..." ) )

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

FRM_Bandeau.pack ( )

TKI_Principal.mainloop ( ) 

2. Ajouter des controles à la demande.

import tkinter

def FNC_Ajouter ( ) :

kcontroles = len ( FRM_Bandeau.panes ( ) ) - 2

kinsertion = tkinter.Label ( FRM_Bandeau , text = f" N°{ kcontroles } " , relief = "solid" )

if SPI_Place.get ( ) == "premier" :

kpremier = FRM_Bandeau.panes ( ) [ 0 ]

FRM_Bandeau.add ( kinsertion , padx = 4 , pady = 7 , before = kpremier )

elif SPI_Place.get ( ) == "avant moi" :

FRM_Bandeau.add ( kinsertion , padx = 4 , pady = 7 , before = SPI_Place )

elif SPI_Place.get ( ) == "après moi" :

FRM_Bandeau.add ( kinsertion , padx = 4 , pady = 7 , after = SPI_Place )

else :

FRM_Bandeau.add ( kinsertion , padx = 4 , pady = 7 )

TKI_Principal = tkinter.Tk ( )

FRM_Bandeau = tkinter.PanedWindow ( TKI_Principal , sashrelief = "groove" , relief = "groove" )

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

BUT_Ajouter = tkinter.Button ( FRM_Bandeau , text = "Ajouter" , command = FNC_Ajouter )

SPI_Place = tkinter.Spinbox ( FRM_Bandeau , values = ( "premier" , "avant moi" , "après moi" , "dernier" ) )

FRM_Bandeau.add ( SPI_Place , padx = 4 , pady = 7 )

FRM_Bandeau.add ( BUT_Ajouter , padx = 4 , pady = 7 )

FRM_Bandeau.add ( BUT_Quitter , padx = 4 , pady = 7 )   

FRM_Bandeau.pack ( padx = 5 , pady = 2 )

TKI_Principal.mainloop ( )