DESCRIPTION.

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

SYNTAXE.

TKI_Fenetre.iconbitmap ( image )

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

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

image ⇨ identification de l'icone [ optionnel ]

ou 

TKI_Fenetre.wm_iconbitmap ( image )

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

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

image ⇨ identification de l'icone [ optionnel ]

REMARQUES.

La méthode tkinter.Toplevel ( ).iconbitmap ( ) ne devrait plus être utilisée. Elle est maintenue pour la rétrocompatibilité. On lui préférera, maintenant, la méthode tkinter.Toplevel ( ).iconphoto ( ) pour associer une icone aux fenêtres. En effet, la méthode méthode tkinter.Toplevel ( ).iconbitmap ( ) doit être adaptée à l'environnement de la machine hote du script.

image doit être une référence à un fichier image bitmap valide et existant. image sera transmis au gestionnaire de fenêtres pour être affiché comme l'icone de la fenêtre.

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.BitmapImage ( ) ;

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

Sous les environnements Windows, de Microsoft, le fichier image associé doit être du type .ico. De plus, sous cet environnement, il est possible d'utiliser la forme tkinter.Toplevel ( ).iconbitmap ( default = image ) pour associer image, 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.

Sous les environnements Linux, le fichier image associé doit être conforme à la norme X11, du type .bpm, et doit être précédé du symbole @, par exemple TKI_Fenetre.iconbitmap ( "@mon_icone.xbm" )

Si image est omis, la méthode tkinter.Toplevel ( ).iconbitmap ( ) retourne l'identification de l'icone actuellement associée à la fenêtre ou une chaine vide  (""). 

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

EXEMPLE.

import tkinter , tkinter.filedialog

def FNC_Icone ( ) :

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

if len ( kfichier ) < 1 : return

IMG_Icone [ "file" ] = kfichier

kicone = f"@{kfichier}" if TKI_Principal._windowingsystem == "x11" else kfichier

TKI_Test.iconbitmap ( kicone )

def FNC_Masque ( ) :

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

if len ( kfichier ) < 1 : return

IMG_Masque [ "file" ] = kfichier

kmasque = f"@{kfichier}" if TKI_Principal._windowingsystem == "x11" else kfichier

TKI_Test.iconmask ( kmasque )

TKI_Principal = tkinter.Tk ( )

IMG_Icone = tkinter.BitmapImage ( )

IMG_Masque  = tkinter.BitmapImage ( )

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 )

BUT_Masque = tkinter.Button ( TKI_Principal , text = "Charger le masque" , command = FNC_Masque )

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

LAB_Masque = tkinter.Label ( TKI_Principal , image =  IMG_Masque )

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

LAB_Icone.pack ( )

BUT_Icone.pack ( )

tkinter.Label ( TKI_Principal , text = "Masque de l'icone" ).pack ( ) 

LAB_Masque.pack ( ) 

BUT_Masque.pack ( ) 

BUT_Quitter.pack ( ) 

TKI_Test = tkinter.Toplevel ( )

TKI_Test.geometry ( "+300+75" )

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

TKI_Principal.mainloop ( )