HOWTO · Tkinter

Comment cacher, récupérer et supprimer les widgets Tkinter

Ce tutoriel montre comment cacher, récupérer et supprimer les widgets Tkinter en cliquant sur un bouton.

Sur cette page

La méthode forget d’un gestionnaire de géométrie masque un widget Tkinter tout en le conservant, et un nouvel appel à son gestionnaire permet de l’afficher de nouveau. Utilisez destroy() pour supprimer définitivement un widget : pack() ou grid() ne peut pas faire réapparaître un widget détruit. Les exemples utilisent des rappels de boutons pour agir sur une étiquette. Consultez le guide des boutons Tkinter pour en savoir plus sur les rappels de boutons.

Masquer et réafficher des widgets Tkinter

Si un widget a été ajouté avec pack(), appelez pack_forget() pour le retirer de l’affichage. Le widget existe toujours : pack() peut donc l’afficher de nouveau. Pour les widgets gérés par une grille, grid_forget() efface les paramètres de grille enregistrés, tandis que grid_remove() les conserve pour un appel ultérieur à grid(). Utilisez un seul gestionnaire de géométrie par widget ; ne mélangez pas pack() et grid() pour des widgets partageant le même parent. L’exemple ci-dessous place chaque étiquette dans son propre cadre : les contrôles gérés par pack utilisent pack(), et ceux gérés par une grille n’utilisent grid() qu’à l’intérieur de leur cadre.

Cet exemple sans interface graphique affiche les méthodes à choisir dans les trois cas de masquage et de réaffichage. Dans une fenêtre Tkinter, associez les appels de méthode correspondants à des boutons ; l’interface graphique nécessite un écran de bureau.

methods = (
    ("hide a packed widget", "pack_forget()"),
    ("show a packed widget", "pack()"),
    ("hide and later restore grid placement", "grid_remove() then grid()"),
    ("hide and specify grid placement again", "grid_forget() then grid(row=0, column=0)"),
)

for task, method in methods:
    print(f"{task}: {method}")
hide a packed widget: pack_forget()
show a packed widget: pack()
hide and later restore grid placement: grid_remove() then grid()
hide and specify grid placement again: grid_forget() then grid(row=0, column=0)

Cet exemple Python 3 crée de vrais boutons Tkinter et associe chacun à une opération sur l’étiquette. Les libellés visibles des boutons restent en anglais ; chacun indique l’opération appliquée au widget étiquette. Exécutez l’exemple dans une session de bureau avec la prise en charge de Tk pour utiliser la fenêtre.

import tkinter as tk

try:
    root = tk.Tk()
except tk.TclError:
    print("This example needs a desktop display with Tk support.")
    raise SystemExit(0)
root.title("Hide and recover labels")

pack_frame = tk.Frame(root, padx=8, pady=8)
pack_frame.pack(fill="x")
pack_label = tk.Label(pack_frame, text="Packed label")
pack_label.pack()
tk.Button(pack_frame, text="Hide packed label", command=pack_label.pack_forget).pack()
tk.Button(pack_frame, text="Show packed label", command=pack_label.pack).pack()

grid_frame = tk.Frame(root, padx=8, pady=8)
grid_frame.pack(fill="x")
grid_label = tk.Label(grid_frame, text="Grid label")
grid_label.grid(row=0, column=0, padx=4)
tk.Button(grid_frame, text="Hide and retain grid options", command=grid_label.grid_remove).grid(row=0, column=1, padx=4)
tk.Button(grid_frame, text="Restore retained grid options", command=grid_label.grid).grid(row=1, column=0, padx=4)
tk.Button(
    grid_frame,
    text="Forget grid options",
    command=grid_label.grid_forget,
).grid(row=1, column=1, padx=4)
tk.Button(
    grid_frame,
    text="Restore at row 0, column 0",
    command=lambda: grid_label.grid(row=0, column=0, padx=4),
).grid(row=2, column=0, columnspan=2, pady=4)

root.mainloop()

Les boutons associés à l’étiquette placée avec pack() appellent pack_forget() et pack() sur cette même étiquette. Les boutons de la grille montrent les deux possibilités de réaffichage : grid_remove() conserve la ligne et la colonne d’origine pour que le rappel grid() puisse être appelé sans argument, tandis que grid_forget() efface ces paramètres ; son bouton fournit donc explicitement l’emplacement souhaité. Ces appels modifient la manière dont chaque étiquette est gérée sans la détruire. Pour en savoir plus sur le placement des widgets, consultez les gestionnaires de géométrie Tkinter.

Supprimer définitivement des widgets Tkinter en cliquant sur un bouton

Appelez destroy() sur le widget à supprimer. Dans cet exemple, le bouton « Delete label » appelle label.destroy : il supprime l’étiquette, et non le bouton. Un widget détruit ne peut pas être restauré avec un gestionnaire de géométrie ; créez une nouvelle étiquette si vous en avez besoin plus tard. Exécutez cet exemple Python 3 dans une session de bureau avec la prise en charge de Tk, puis cliquez sur le bouton « Delete label », dont le libellé reste en anglais, pour retirer l’étiquette de la fenêtre.

import tkinter as tk

try:
    root = tk.Tk()
except tk.TclError:
    print("This example needs a desktop display with Tk support.")
    raise SystemExit(0)
root.title("Destroy a label")

label = tk.Label(root, text="This label will be removed")
label.pack(padx=8, pady=8)
tk.Button(root, text="Delete label", command=label.destroy).pack(padx=8, pady=8)

root.mainloop()