DESCRIPTION.

Indique une fonction à exécuter quand la variable de controle de type tkinter.StringVar ( ) est lue, modifiée ou détruite et place un observateur sur cette variable.

SYNTAXE.

TKV_Texte.trace_add  ( action , fonction )

TKV_Texte ⇨ instance quelconque de tkinter.StringVar ( ) [ OBLIGATOIRE ]

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

action ⇨ événement à surveiller [ OBLIGATOIRE ]

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

TKV_Texte.trace_variable ( action , fonction )

TKV_Texte ⇨ instance quelconque de tkinter.StringVar ( ) [ OBLIGATOIRE ]

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

action ⇨ événement à surveiller [ OBLIGATOIRE ]

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

REMARQUES.

Avec la méthode tkinter.StringVar ( ).trace_add ( ), action doit est un str ( ) qui peut prendre l'une des valeurs suivantes : 

- "read", pour exécuter fonction quand la variable de controle est lue ;

- "write", pour exécuter fonction quand la variable de controle est modifiée ;

- "unset", pour exécuter fonction quand la variable de controle est détruite.

Avec la méthode tkinter.StringVar ( ).trace_variable ( ), action doit est un str ( ) qui peut prendre l'une des valeurs suivantes : 

- "r", pour exécuter fonction quand la variable de controle est lue ;

- "w", pour exécuter fonction quand la variable de controle est modifiée ;

- "u", pour exécuter fonction quand la variable de controle est détruite.

fonction doit être une fonction, quelconque mais valide, définie par le script, ou une méthode native de Python ou importée d'un module. Le nom de la fonction appelée, ne doit pas être suivie des parenthèses.

La méthode tkinter.StringVar ( ).trace_add ( ) permettra de suspendre la surveillance d'un événement sur la variable de controle liée, avec la méthode tkinter.StringVar ( ).trace_remove ( ), contrairement à tkinter.StringVar ( ).trace ( ). qui appliquera une surveillance définitive.

La méthode tkinter.StringVar ( ).trace_variable ( ) ne doit plus être utilisée depuis Python 3.5, sa présence dans la liste de méthodes de tkinter permet juste la compatibilité des anciens scripts.

Pour surveiller plusieurs événements, liés à une même variable de controle, devant appeler la même fonction fonction. il est possible de regrouper plusieurs actions dans une list ( ) ou un tuple ( ). Par exemple : [ "write" , "read" ] ou ( "write" , "read" , "unset" ).

tkinter.StringVar ( ).trace_add ( ) passent, automatiquement, un tuple ( ) de 3 éléments à la fonction appelée : l'identifiant de la variable de controle (ex. : PY_VAR0) ; un str ( ) vide et la nature de l'événement qui déclenchée l'appel ("write", "read" ou "unset"). La définition de la fonction fonction, doit donc prévoir ce passage d'argument.

EXEMPLE. 

import tkinter

def FNC_Fond ( *event ) :

TKI_Principal [ "background" ] = TKV_Couleur.get ( )

LAB_Temoin [ "background" ] = TKV_Couleur.get ( )

TKI_Principal = tkinter.Tk ( )

TKV_Couleur = tkinter.StringVar ( )

SPI_Valeur = tkinter.Spinbox ( TKI_Principal , textvariable = TKV_Couleur  , wrap = True )

LAB_Temoin = tkinter.Label ( TKI_Principal , textvariable = TKV_Couleur )

LAB_Temoin.pack ( )

SPI_Valeur.pack ( )

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

TKV_Couleur.trace_add ( "write" , FNC_Fond )

SPI_Valeur [ "values" ] = "red lime blue yellow magenta aqua black lavender" 

TKI_Principal.mainloop ( )