DESCRIPTION.

Créer et ajoute un nouveau élément visuel d'un controle dans le thème actuel.

SYNTAXE.

STY_Theme.element_create ( nom , type , attribut1 = valeur , ... , attributn = valeur )

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

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

nom ⇨ identifiant de l'élément [ OBLIGATOIRE ]

type ⇨ nature de l'élément [ optionnel ]

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

REMARQUES.

type est un str ( ) qui peut valoir "from", "image" ou "vsapi".

Si source vaut "from" alors un élément issu d'un thème tkinter.tkk sera cloné comme base du nouvel élément, ou à défaut un élément vierge. La méthode tkinter.tkk.Style ( ).element_create ( ) prendra la forme suivante : 

STY_Theme.element_create ( nom , "from" , theme , element ) où :

- nom est un str ( ) qui doit être valide pour un identifiant d'élément de thème tkinter.tkk ;

- theme est l'identifiant du thème tkinter.tkk depuis lequel sera cloné un élément existant ;

- element est l'identifiant du élément tkinter.tkk issue de theme, si element est omis un élément vide sera utilisé.

Si type vaut "image" alors la méthode tkinter.tkk.Style ( ).element_create ( ) prendra la forme suivante : 

STY_Theme.element_create ( nom , "image" , source ( etat , valeur ) , attribut1 = valeur , ... , attributn = valeur ) où :

- nom est un str ( ) qui doit être valide pour un identifiant d'élément de thème tkinter.tkk ;

- type est le nom de l'image et ( etat , valeur ) se rapportant à l'image ;

- attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur, pouvant être :

border = [ gauche , haute , droite , base ]

gauche , haute , droite , base sont des int ( ) indiquant l'épaisseur, en pixels, des bordures de l'image.

height = hauteur

hauteur est un int ( ) de la hauteur, en pixels, de l'image. Si hauteur est omis ou inférieur à 0, la hauteur est celle d'origine.

padding = marge

marge est un int ( ) de la marge, en pixels, interieure. Si marge est omis la marge sera celle de la bordure.

sticky = place

place est un str ( ) qui peut être : "n", "e" , "s", "w", "" ou une combinaison de ces valeurs.

width = largeur

largeur est un int ( ) de la largeur, en pixels, de l'image. Si largeur est omis ou inférieur à 0, la largeur est celle d'origine.

Le type valant "vsapi" n'était disponible que dans Tk 8.6a pour Windows XP et Vista. Obsolète, il n'est donc plus ni utile ni documenté.

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

EXEMPLE.

import tkinter 

import tkinter.ttk 

TKI_Principal = tkinter.Tk ( ) 

STY_Theme = tkinter.ttk.Style ( ) 

STY_Theme.element_create ( "quitter" , "image" , "normal.gif" , 

( "active" , "active.gif" ) , ( "pressed" , "appuye.gif" ) , 

border = [ 5 , 10 , 5 , 10 ] , width = 128 , height = 96 , sticky = "nesw" )

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

TKI_Principal.mainloop ( )