Tkinter Listbox显示异常：自定义带Scrollbar的Listbox仅显示滚动条

你的代码错误地将Scrollbar作为Listbox的子组件，但Listbox并非容器控件，无法正确容纳其他组件。当你对Scrollbar执行pack操作后，滚动条会占据Listbox的全部显示空间，导致Listbox本身被遮挡无法显示。

修改后的代码 #

import tkinter as tk

class ScrollableListbox(tk.Frame):
    def __init__(self, master, *args, **kwargs):
        super().__init__(master)
        # 创建Listbox和Scrollbar组件
        self.listbox = tk.Listbox(self, *args, **kwargs)
        self.scrollbar = tk.Scrollbar(self)

        # 关联滚动条与Listbox的滚动行为
        self.listbox.config(yscrollcommand=self.scrollbar.set)
        self.scrollbar.config(command=self.listbox.yview)

        # 布局组件：滚动条贴右侧垂直填充，Listbox占满剩余空间
        self.scrollbar.pack(side=tk.RIGHT, fill=tk.Y)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

    # 代理Listbox的insert方法，保持外部调用习惯一致
    def insert(self, *args, **kwargs):
        self.listbox.insert(*args, **kwargs)

    # 可根据需要代理更多Listbox方法，比如delete、get等
    def delete(self, *args, **kwargs):
        self.listbox.delete(*args, **kwargs)

if __name__ == "__main__":
    root = tk.Tk()
    root.geometry("300x300")
    scrollable_listbox = ScrollableListbox(root)
    # 让容器组件占满窗口可用空间
    scrollable_listbox.pack(fill=tk.BOTH, expand=True)

    for i in range(1, 21):
        scrollable_listbox.insert("end", f"Item {i}")

    root.mainloop()

关键修改说明 #

1. 自定义类改为继承tk.Frame：Frame是标准容器控件，可同时容纳Listbox和Scrollbar两个组件
2. 分离Listbox与Scrollbar的层级：两者作为Frame的同级子组件，避免互相遮挡
3. 优化布局规则：Listbox设置fill=tk.BOTH, expand=True，确保窗口大小变化时能自适应填充空间
4. 代理Listbox核心方法：让自定义组件的外部调用方式与原生Listbox保持一致，降低使用成本

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