如何在Custom Tkinter滚动框架（CTkScrolledFrame）上方放置标签？

核心问题原因 #

你直接将组件挂载到CTkScrolledFrame实例上是错误的——CTkScrolledFrame内部封装了一个真正承载内容的子框架，必须把组件放在这个子框架里，否则会被滚动区域的裁剪逻辑干扰，导致显示异常。

修复后的基础写法 #

直接使用CTkScrolledFrame的.scrollable_frame属性作为父容器：

import customtkinter as ctk

ctk.set_appearance_mode("light")
ctk.set_default_color_theme("blue")

window = ctk.CTk()
window.geometry("400x500")

# 初始化滚动框架（注意拼写：CTkScrolledFrame，你原代码里少了个'r'）
homePage = ctk.CTkScrolledFrame(window, width=300, height=400)
homePage.pack(pady=20)  # 先把滚动框架放到主窗口

# 必须挂载到scrollable_frame上
label = ctk.CTkLabel(homePage.scrollable_frame, text='Hello')
label.place(relx=0.4, rely=0.5, anchor=ctk.CENTER)

window.mainloop()

自定义滚动框架类的正确写法 #

如果需要封装自定义类，参考官方逻辑实现，避免初始化错误：

import customtkinter as ctk

class MyScrolledFrame(ctk.CTkScrolledFrame):
    def __init__(self, master, **kwargs):
        super().__init__(master, **kwargs)
        
        # 在内部scrollable_frame上创建组件
        self.label = ctk.CTkLabel(self.scrollable_frame, text="自定义滚动框内的标签")
        self.label.pack(pady=50)
        
        # 可以添加更多组件
        self.button = ctk.CTkButton(self.scrollable_frame, text="测试按钮")
        self.button.pack(pady=20)

window = ctk.CTk()
window.geometry("400x500")

my_frame = MyScrolledFrame(window, width=300, height=400)
my_frame.pack(pady=20)

window.mainloop()

额外注意点 #

1. 原代码里的CTkScolledFrame是拼写错误，正确是CTkScrolledFrame（多一个'r'），这也可能导致隐藏报错。
2. 使用place布局时，确保rely等相对坐标是基于内部scrollable_frame的尺寸，而非外层框架。如果内容较多，建议用pack或grid，它们能自动撑开滚动区域的高度/宽度。

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