DESCRIPTION.

Définie une image bitmap comme masque pour l'icone bitmap associée à la fenêtre.

SYNTAXE.

TKI_Fenetre.iconmask ( masque )

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

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

masque ⇨ ifichier bitmap [ optionnel ]

ou 

TKI_Fenetre.wm_iconmask ( masque )

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

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

masque ⇨ fichier bitmap [ optionnel ]

REMARQUES.

Comme la méthode tkinter.Toplevel ( ).iconmask ( ) est un complément à méthode tkinter.Toplevel ( ).iconbitmap ( ) elle 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, les méthodes tkinter.Toplevel ( ).iconbitmap ( ) et tkinter.Toplevel ( ).iconmask ( )  doivent être adaptées à l'environnement de la machine hote du script.

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

masque 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 du masque à l'icone de la fenêtre.

Un fichier image de type bitmap restitue une image monochrome et est constituée de d'une suite de données binaires, 0 indique que le point sera de la couleur du fond et 1 qu'il sera de la couleur de l'encre. Le fichier masque associé à l'icone de la fenêtre, modifie l'aspect du graphe de l'icone, si la donnée, au coordonnées du point de l'icone est : 

- 0, le point sera de la couleur du fond, 

- 1 le point ne sera pas modifié, fond ou encre.

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

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

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