DESCRIPTION.

Précise ou retourne les fenêtres avec une palette de couleurs privées.

SYNTAXE.

TKI_Fenetre.colormapwindows ( fenetres )

TKI_Fenetre ⇨ instance de la fenêtre tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

fenetres  ⇨ liste de fenêtres valides [ optionnel ]

ou  

TKI_Fenetre.wm_colormapwindows ( fenetres )

TKI_Fenetre ⇨ instance de la fenêtre tkinter.Toplevel ( ) [ OBLIGATOIRE ]

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

fenetres  ⇨ liste de fenêtres valides [ optionnel ]

REMARQUES.

fenetres doit être une list ( ) dont les éléments sont des références, variables ou chemins, à des objets Tk ( ) ou Toplevel ( ) valides. 

La méthode Toplevel ( ).colormapwindows ( fenetres ) transfère fenetres dans la constante WM_COLORMAP_WINDOWS du gestionnaire de fenêtres. Les éléments de fenetres sont, et ne devraient être que, les fenêtres de l’application disposant d'une palette de couleurs privées. 

Quand la fenêtre obtient le focus, le gestionnaire de fenêtre chargera autant de palettes de couleurs qu'il lui sera possible, et dans l'ordre des éléments présents dans la constante WM_COLORMAP_WINDOWS.

Si aucune palette de couleurs n'est présente dans la constante WM_COLORMAP_WINDOWS tkinter y ajoute, automatiquement, celle de la fenêtre principale et sera appliquée à toutes les fenêtres qui n'ont pas indiquées de palettes de couleurs privées.

Utilisée sans argument, la méthode Toplevel ( ).colormapwindows ( ) retourne une list ( ) contenant les objets Tk ( ) et Toplevel ( ) actuellement présents dans la constante WM_COLORMAP_WINDOWS du gestionnaire de fenêtres, ou une  list ( ) vide. 

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

Pour des informations complémentaires sur la constante WM_COLORMAP_WINDOWS et sur les palettes de couleurs des gestionnaires de fenêtres, consultez la documentation ICCCM.

EXEMPLE.

import tkinter

TKI_Principal = tkinter.Tk ( )

TKI_Fenetre = tkinter.Toplevel ( )

kavant = TKI_Fenetre.colormapwindows ( )

TKI_Fenetre.colormapwindows ( [ TKI_Fenetre ] )

kapres = TKI_Fenetre.colormapwindows ( )

tkinter.Label ( TKI_Fenetre , text = kavant ).pack ( )

tkinter.Label ( TKI_Fenetre , text = kapres ).pack ( )

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

TKI_Principal.mainloop ( )