Tkinter Treeview长文本显示问题：尺寸调整与水平滚动条添加

问题场景 #

开发了一款包含Treeview组件和选中条目详情展示组件的GUI，目前Treeview尺寸不足，导致部分长文本条目无法完整显示。

问题示意图：Treeview中的长文本条目被横向截断，仅能显示部分内容。

相关代码 #

# This is a sample Python script.

# Press Umschalt+F10 to execute it or replace it with your code.
# Press Double Shift to search everywhere for classes, files, tool windows, actions, and settings.
import tkinter as tk


import tkinter as tk
from tkinter import ttk
from tkinter import Label, Entry, Button, Checkbutton
from tkinter.messagebox import showinfo
from tkinter import *
from tkinter.ttk import Progressbar
import time
import threading


class MainWindow:
    """
    Lib description

    == Table of contents ==

    %TOC%
    """

    ROBOT_LIBRARY_SCOPE = "GLOBAL"
    # ------------------------------------------
    def __init__(self, root: tk.Tk = None):
        self.root = root


        self.create_widgets()

    def create_widgets(self):
        """
        Build and visualize all the widgets of launcher gui tool

        Out\n
        | return_status_bln | False: Error, True: No Error  |\n
        """
        
        self.label_frame_tree = tk.LabelFrame(self.root, text="Projects", font=("Helvetica", 13))   
        self.label_frame_tree.pack(fill=tk.X, side="left", padx=10, pady=5  )   
        
        self.tree = ttk.Treeview(self.label_frame_tree, height=6 )
        self.tree.pack(fill=tk.X, side="left", padx=10, pady=5)

        self.tree.heading('#0', text='Departments', anchor=tk.W)

        # adding data
        id_prj = self.tree.insert('', tk.END, text='Project', iid=0, open=False)
        self.tree.insert('', tk.END, text='Pool', iid=1, open=False)

        # adding children of first node
        value_dct = {"a":1, "b":2}
        id_opwrt = self.tree.insert(id_prj, tk.END, values=value_dct, text='main 1', iid=5, open=False)
        self.tree.insert(id_opwrt, tk.END, text='sub1 ssssssssssssssssssssssssssssssssssssssssssssssss', open=False)
        self.tree.insert(id_opwrt, tk.END, text='sub2', open=False)
        
        values_lst = ("1","2")
        self.tree.insert(id_prj, tk.END, values=values_lst, text='main 2', iid=6, open=False)

        self.label_frame_info = tk.LabelFrame(self.root, text="Info Detail", font=("Helvetica", 13))

        self.label1 = tk.Label(self.label_frame_info, text="Project")
        self.label1.grid(row=0, column=0, padx=10, pady=5)
        self.text_info_1 = tk.Entry(self.label_frame_info,width=40)
        self.text_info_1.grid(row=0, column=1, padx=10, pady=5)
        

        # sub project
        self.label2 = tk.Label(self.label_frame_info, text="Subproject")
        self.label2.grid(row=1, column=0, padx=10, pady=5)
        self.text_info_2 = tk.Entry(self.label_frame_info,width=40)
        self.text_info_2.grid(row=1, column=1, padx=10, pady=5)

        self.label_frame_info.pack(fill=tk.X, side="left", padx=10, pady=5)   


        return_status_bln = True




def main():
    # Create a window
    root = tk.Tk()

    # Set the window title
    root.title("GUI")

    # Set the window size
    root.geometry("900x600")

    # Create the main window
    MainWindow(root)

    # Start the window's event-loop
    root.mainloop()

if __name__ == "__main__":
    print("123")
    main()

问题解答 #

1. 如何调整Treeview的尺寸以完整显示长文本条目？ #

有两种实用方式：

• 固定宽度设置：直接给Treeview指定width参数，比如self.tree = ttk.Treeview(self.label_frame_tree, height=6, width=80)，但这种方式不够灵活，若文本长度变化可能再次出现截断。
• 自动适配最长文本：遍历Treeview中所有条目的文本，计算最长文本的宽度，再设置Treeview的列宽。示例代码如下：

  # 计算最长文本宽度
  max_width = 0
  font = tk.font.Font()
  for item in self.tree.get_children():
      # 遍历顶层条目
      text_width = font.measure(self.tree.item(item)['text'])
      if text_width > max_width:
          max_width = text_width
      # 遍历子条目
      for child in self.tree.get_children(item):
          child_width = font.measure(self.tree.item(child)['text'])
          if child_width > max_width:
              max_width = child_width
  # 设置列宽，额外加20避免边缘截断
  self.tree.column('#0', width=max_width + 20)
  

  同时需要修改LabelFrame的布局参数，让它能横向扩展：

  self.label_frame_tree.pack(fill=tk.BOTH, expand=True, side="left", padx=10, pady=5)
  

2. 改用grid布局并设置列尺寸是否为更优解决方案？ #

grid布局在复杂多组件排版上比pack更灵活，但针对当前Treeview宽度不足的问题，核心是给Treeview足够的横向空间，pack和grid都能实现：

• 如果后续GUI需要更复杂的行列布局（比如新增多行多列的组件），grid会更便于管理；
• 如果只是当前的左右两个LabelFrame结构，pack的代码更简洁，完全能满足需求。
  所以是否改用grid取决于后续的GUI扩展需求，当前问题的核心并非布局方式，而是解决Treeview的横向空间问题。

3. 如何为Treeview添加水平滚动条？ #

可以通过绑定ttk.Scrollbar来实现，步骤如下：

1. 在Treeview所在的LabelFrame中创建水平滚动条；
2. 绑定滚动条与Treeview的xview事件；
3. 调整Treeview和滚动条的布局，让滚动条显示在Treeview下方。

修改后的create_widgets相关代码片段：

self.label_frame_tree = tk.LabelFrame(self.root, text="Projects", font=("Helvetica", 13))   
# 修改LabelFrame布局，允许横向扩展
self.label_frame_tree.pack(fill=tk.BOTH, expand=True, side="left", padx=10, pady=5)   

self.tree = ttk.Treeview(self.label_frame_tree, height=6 )
# 创建水平滚动条
h_scroll = ttk.Scrollbar(self.label_frame_tree, orient="horizontal", command=self.tree.xview)
self.tree.configure(xscrollcommand=h_scroll.set)

# 调整Treeview和滚动条的布局
self.tree.pack(fill=tk.BOTH, side="top", padx=10, pady=(5,0))
h_scroll.pack(fill=tk.X, side="bottom", padx=10)

添加后，当Treeview内容超出显示宽度时，可通过拖动水平滚动条查看完整文本。

内容的提问来源于stack exchange，提问作者gthorsten