如何修改自定义tkinter可滚动Frame类 使其可直接作为控件父容器
调整方案
完全可以实现和原生Frame完全一致的使用体验,不需要用户手动指定内部的承载Frame当父容器。
原来的实现之所以存在这个使用限制,是因为结构设计上把“放置Canvas、滚动条的外层容器”和“承载用户控件的内容Frame”做了拆分:用户拿到的实例是外层容器,自然无法直接用来当父容器放子控件,只能手动访问内部的content Frame。
调整思路非常简单:把两个角色互换——
- 用户最终拿到的
scrolledFrame实例,本身就是那个用来承载所有用户控件的内容Frame。 - 用来放置Canvas、滚动条的外层容器、Canvas窗口嵌入逻辑、滚动适配逻辑,全部封装在类的内部,用户完全不需要感知。
- 重写类的布局方法(
pack/grid/place),让用户对scrolledFrame实例调用的布局操作,实际作用在内部的外层容器上,保证整体能正常嵌入父窗口。
调整后的完整代码
import tkinter as tk class scrolledFrame(tk.Frame): def __init__(self, parent): # 初始化当前实例:本身就是用来承载用户控件的内容Frame super().__init__() # 内部私有外层容器:用来放置Canvas和滚动条,用户无感知 self._outer = tk.Frame(parent) self.canvas = tk.Canvas(self._outer) self.canvas.pack(fill="both", expand=True, side="left") self.scroll = tk.Scrollbar(self._outer, command=self.canvas.yview) self.scroll.pack(side="right", fill="y") self.canvas.config(yscrollcommand=self.scroll.set) # 把当前实例(内容Frame)嵌入Canvas的窗口中 self._content_window = self.canvas.create_window((0,0), window=self, anchor="nw") # 绑定原有滚动相关事件 self.bind("<Configure>", self._update_scroll_region) self.bind("<Enter>", self._bind_mouse_wheel) self.bind("<Leave>", self._unbind_mouse_wheel) # 重写所有布局方法,把用户的布局操作转发到外层容器 def pack(self, *args, **kwargs): self._outer.pack(*args, **kwargs) def grid(self, *args, **kwargs): self._outer.grid(*args, **kwargs) def place(self, *args, **kwargs): self._outer.place(*args, **kwargs) # 原有功能逻辑完全保留 def _scroll_canvas(self, event): self.canvas.yview_scroll(int(-1*(event.delta/120)), "units") def _bind_mouse_wheel(self, event): self.canvas.bind_all("<MouseWheel>", self._scroll_canvas) def _unbind_mouse_wheel(self, event): self.canvas.unbind_all("<MouseWheel>") def _update_scroll_region(self, event): self.update_idletasks() self.canvas.config(scrollregion=self.canvas.bbox("all")) # 让内容Frame宽度和Canvas宽度保持一致 self.canvas.itemconfig(self._content_window, width=self.canvas.winfo_width()) # 补全销毁逻辑,避免资源泄漏 def destroy(self): self._outer.destroy() super().destroy()
调整后的使用方式
和原生tk.Frame的用法完全没有区别,不需要手动访问任何内部属性:
root = tk.Tk() exampleFrame = scrolledFrame(root) # 直接调用布局方法即可,实际会作用在外层容器上 exampleFrame.pack(fill="both", expand=True) # 直接把exampleFrame当父容器,不需要加.content exampleLabel = tk.Label(exampleFrame, text = "I'm in the scrolled frame!") exampleLabel.pack() root.mainloop()
效果说明
- 所有原有功能(垂直滚动、鼠标滚轮响应、滚动区域自适应、内容宽度跟随窗口变化)完全保留,没有任何功能损失。
- 因为scrolledFrame实例本身就是原生Frame,所以所有支持
master参数的Tkinter控件,都可以直接把它当父容器使用,和普通Frame没有任何体验差异。 - 内部的Canvas、滚动条、外层容器都是私有属性,不会和用户添加的控件发生布局冲突。
内容的提问来源于stack exchange,提问作者Henry
相关产品推荐
相关产品推荐

