DESCRIPTION.

Définie une image comme icone associée et représentant la fenêtre réduite.

SYNTAXE.

TKI_Fenetre.iconphoto ( portee , image )

TKI_Fenetre ⇨ instance quelconque de tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

portee ⇨ portée de l'icone [ OBLIGATOIRE ]

image ⇨ identification de l'icone [ OBLIGATOIRE ]

ou 

TKI_Fenetre.wm_iconphoto ( portee , image )

TKI_Fenetre ⇨ instance quelconque de tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

portee ⇨ portée de l'icone [ OBLIGATOIRE ]

image ⇨ identification de l'icone [ OBLIGATOIRE ]

REMARQUES.

portee doit être un bool ( ). Si portee vaut : 

- False, image sera associer uniquement à la fenêtres  appelante ;

- True, image sera associer, par défaut, à toutes les fenêtres de l'applications, celles déjà présentes ainsi que celles qui seront créées ensuite, et qui ne sont pas spécifiquement associées à une autre icone.

image doit être une référence à un fichier image valide et existant. image sera transmis au gestionnaire de fenêtres pour être affiché comme l'icone de la fenêtre. image peut spécifier plusieurs fichiers images, en particulier de tailles différentes, dans ce cas, le gestionnaire de fenêtre choisira l'image la mieux adaptée à la taille de l'icone. Seuls les formats .gif, .png , .ppm et .pgm sont pris en charge par tkinter. 

image peut être :

- le nom d'un fichier, si il ne se trouve pas dans le même répertoire que le script, image doit contenir le chemin absolu de fichier ;

- un objet de la classe tkinter.PhotoImage ( ) ;

- une chaine vide ("") pour annuler l'association actuelle de l'icone et de la fenêtre.

Sur les environnements de type Linux et Windows, les images sont emballées dans une structure d'icone Windows. l'appel de la méthode tkinter.Toplevel ( ).iconphoto ( ) remplacera une icone de tkinter par défaut. Sur Macintosh, l'appel est ignoré.

La forme TKI_Fenetre.wm_iconphoto ( ) appelle la méthode wm_iconphoto ( ) 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 , tkinter.filedialog

def FNC_Icone ( ) :

kfichier = tkinter.filedialog.askopenfilename ( title = "Sélectionnez" )

if len ( kfichier ) < 1 : return

IMG_Icone [ "file" ] = kfichier

TKI_Test.iconphoto ( False , IMG_Icone )

TKI_Principal = tkinter.Tk ( )

IMG_Icone = tkinter.PhotoImage ( )

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

BUT_Icone = tkinter.Button ( TKI_Principal , text = "Charger l'icone" , command = FNC_Icone )

LAB_Icone = tkinter.Label ( TKI_Principal , image =  IMG_Icone )

tkinter.Label ( TKI_Principal , text = "Icone de base" ).pack ( ) 

LAB_Icone.pack ( )

BUT_Icone.pack ( )

BUT_Quitter.pack ( ) 

TKI_Test = tkinter.Toplevel ( )

TKI_Test.title ( "Test" )

TKI_Test.geometry ( "+300+75" )

tkinter.Button ( TKI_Test , text = "Clique Moi" , command = TKI_Test.iconify ).pack ( ) 

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

TKI_Principal.mainloop ( )