DESCRIPTION.

Modifie, ou retourne, l'état visuel de la fenêtre principale de l'interface graphique.

SYNTAXE.

TKI_Principal.state ( etat )

TKI_Principal ⇨ instance de la fenêtre tkinter.Tk ( ) [ OBLIGATOIRE ]

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

etat ⇨ état de la fenêtre [ optionnel ]

ou  

TKI_Principal.wm_state ( etat )

TKI_Principal ⇨ instance quelconque de tkinter.Tk ( ) [ OBLIGATOIRE ]

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

etat ⇨ état de la fenêtre [ optionnel ]

REMARQUES.

doit être un str ( ) pouvant prendre l'une des valeurs suivantes : 

- "iconic" ; pour mettre la fenêtre principale en icone, cela équivaut à tkinter.Tk ( ).iconify ( ) et tkinter.Tk ( ).deiconify ( ) ;

- "normal" ; pour annuler les autres appels de la méthode tkinter.Tk ( ).state ( ) ;

- "withdrawn" ; pour cacher la fenêtre principale, cela équivaut à tkinter.Tk ( ).withdrawn ( ).

Avec l’utilisation de tkinter.Tk ( ).state ( "normal" ), la fenêtre principale retrouvera la même position et les mêmes dimensions que celles qu'elle avait avant sa mise en icone ou son effacement.

Le premier appel de tkinter.Tk ( ).state ( "iconic" ), réduit la fenêtre principal, le deuxième la fait sortir du mode icone.

Utilisée sans aucun paramètre, la méthode tkinter.Tk ( ).state ( ) retourne l'état actuellement en cour. 

La forme TKI_Principal.wm_state ( ) appelle la méthode wm_state ( ) 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.

Le comportement de cette méthode, peut varier selon l'environnement utilisé. Il peut même, dans certain cas, être ignoré.

EXEMPLE.

import tkinter

TKI_Principal = tkinter.Tk ( )

TKI_Principal.geometry ( "320x240+300+100" )

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

TKI_Action = tkinter.Toplevel ( )

TKI_Action.geometry ( "+100+100" )

tkinter.Button ( TKI_Action , text = "Réduire ..." , command = lambda : TKI_Principal.state ( "iconic" ) ).pack ( fill = "both" )

tkinter.Button ( TKI_Action , text = "Cacher ..." , command = lambda : TKI_Principal.state ( "withdrawn" ) ).pack ( fill = "both" )

tkinter.Button ( TKI_Action , text = "Rétablir ..." , command = lambda : TKI_Principal.state ( "normal" ) ).pack ( fill = "both" )

tkinter.Label ( TKI_Action , text = "... la fenêtre principale." ).pack ( fill = "both" )

TKI_Principal.mainloop ( )