{"id":1546,"date":"2020-12-09T03:58:14","date_gmt":"2020-12-09T03:58:14","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=1546"},"modified":"2025-04-04T08:45:17","modified_gmt":"2025-04-04T08:45:17","slug":"tkinter-treeview","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/tkinter\/tkinter-treeview\/","title":{"rendered":"Tkinter Treeview"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn about the Tkinter Treeview widget and how to use it to display hierarchical and tabular data.<\/p>\n\n\n\n

Introduction to the Tkinter Treeview widget #<\/a><\/h2>\n\n\n\n

A Treeview<\/code> widget allows you to display hierarchical collection of items. Each item has a label, an optional icon<\/a>, and an optional list of data values. A Treeview<\/code> widget displays data values in successive columns after the tree label.<\/p>\n\n\n\n

For example, the following picture shows how to use a Treeview<\/code> to display employees by cities:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Additionally, you can use a Treeview<\/code> widget to display the same employee list as a table:<\/p>\n\n\n\n

\"tkinter<\/figure>\n\n\n\n

The Treeview widget allows both horizontal and vertical scrollbars<\/a>.<\/p>\n\n\n\n

Creating a Treeview #<\/a><\/h2>\n\n\n\n

To create a Treeview<\/code> widget, you follow these steps:<\/p>\n\n\n\n

First, import ttk<\/code> module from tkinter<\/code>:<\/p>\n\n\n

from<\/span> tkinter import<\/span> ttk<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Second, create a tree view using the Treeview<\/code> constructor:<\/p>\n\n\n
treeview = ttk.Treeview(master=None<\/span>, **kw)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
For example, the following program creates an empty Treeview<\/code>:<\/p>\n\n\n
import<\/span> tkinter as<\/span> tk\nfrom<\/span> tkinter import<\/span> ttk\n\nroot = tk.Tk()\nroot.title(\"Tkinter Treeview\"<\/span>)\nroot.geometry(\"500x300\"<\/span>)\n\ntreeview = ttk.Treeview()\n\ntreeview.pack(padx=10<\/span>,pady=10<\/span>, expand=True<\/span>, fill=tk.BOTH)\n\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"tkinter<\/figure>\n\n\n\n
Adding items to a Treeview #<\/a><\/h2>\n\n\n\n
You can add an item to a tree view by using the insert()<\/code> method of the Treeview<\/code> object. For example, the following program adds an item (San Jose<\/code>) to the Treeview<\/code>:<\/p>\n\n\n
import<\/span> tkinter as<\/span> tk\nfrom<\/span> tkinter import<\/span> ttk\n\nroot = tk.Tk()\nroot.geometry(\"400x300\"<\/span>)\nroot.title(\"Tkinter Treeview\"<\/span>)\n\ntreeview = ttk.Treeview()\nlevel1 = treeview.insert(\"\"<\/span>, tk.END, text=\"San Jose\"<\/span>)\n\ntreeview.pack(fill=tk.BOTH, expand=True<\/span>, padx=10<\/span>, pady=10<\/span>)\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"tkinter<\/figure>\n\n\n\n
In this example, we add an item with label (San Jose<\/code>) to the Treeview<\/code> using the following insert()<\/code> method:<\/p>\n\n\n
level1 = treeview.insert(\"\"<\/span>, tk.END, text=\"San Jose\"<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
The insert()<\/code> method accepts three arguments:<\/p>\n\n\n\n