DESCRIPTION.

Modifie, ou retourne, la disposition des éléments d'un controle associé au style précisé.

SYNTAXE.

LST_Elemests = STY_Theme.layout ( style , disposition )

LST_Elemests = ⇨ variable qui recevra la valeur [ optionnel ]

STY_Theme = ⇨ instance quelconque de tkinter.ttk.Style ( ) [ OBLIGATOIRE ]

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

style ⇨ identifiant du style [ OBLIGATOIRE ]

disposition ⇨ agencement des élément dans le controle [ optionnel ]

REMARQUES.

style est un str ( ) identifiant un nom de style. Si style n'existe pas dans le thème de styles actuellement utilisé par l'interface graphique, il est créé. style doit avoir la forme :

- ".", qui est le style ancêtre de tous les autres styles du thème ;

- "defaut", où defaut est le nom du style par défaut du type de controle, par exemple "TButton" ;

- "prefixe.defaut", où prefixe.defaut est le nom d'un style obtenu après clonage de defaut, par exemple "boss.TButton".

disposition doit être un objet séquence tel que list ( ) ou tuple ( ), à l'exception d'un str ( ) présentant la disposition des éléments du controle en mettant en valeur la relation parent-enfant entre eux est ayant une forme générale suivante :  

[ ( composant ,  { options , "children" :

 [ ( composant ,  { options , "children" : 

[ ( composant ,  { options , "children" : 

[ ( ...

... } ) ]

où : 

- composant est un des éléments du controle ayant la forme "controle.element" ;

- options est un dict ( ) avec les couples attribut:valeur modifiés où attribut peut être : expand, side, sticky ;

- "children", le dernier couple clé:valeur désignant l'élément imbriqué dans composant.

Si disposition est absent, ou None, la méthode tkinter.ttk.Style ( ).layout ( ) retourne la mise en page, disposition, actuelle des éléments dans le controle.

L'imbrication des éléments dans le controle se fait grâce à une version simplifiée du gestionnaire de placement tkinter.pack ( ), étant donné un conteneur primitif, chaque élément se voit attribuer une une portion de ce conteneur.

Voir la méthode tkinter.tkk.Style ( ).element_create ( ) pour plus d'informations sur les éléments de style.

Voir les généralités sur les styles tkinter.ttk pour plus d'informations.

EXEMPLE.

import tkinter , tkinter.ttk

TKI_Principal = tkinter.Tk ( )

tkinter.ttk.Style ( ).layout ( "stop.TButton" ,

[ ( "Button.border" , { "sticky" : "nswe" , "border" : "1" , "children" : 

[ ( "Button.focus" , { "sticky" : "nswe" , "children" : 

[ ( "Button.padding" , { "sticky" : "nswe" , "children" :

[ ( "Button.label" , { "sticky" : "nswe" } ) ]

} ) ]

} ) ] 

} ) ]

)

tkinter.ttk.Button ( TKI_Principal , text = "Quitter" ,  style  = "stop.TButton" , command = TKI_Principal.destroy ).pack ( )

TKI_Principal.mainloop ( )