CTK Frame中CTK Image超出边界且显示异常问题咨询

要让尺寸50的CTkImage在宽高40、圆角40的CTkFrame内以圆形显示，核心是开启Frame的裁剪功能，再调整图片布局：

关键操作 #

• 给CTkFrame添加clip=True参数：默认Frame不会裁剪超出自身范围的子组件，开启后会自动剪掉边界外的内容。
• 确保图片组件在Frame内居中：避免图片偏移导致显示不全。

代码示例 #

方式1：调整图片尺寸适配Frame #

import customtkinter as ctk

ctk.set_appearance_mode("light")
app = ctk.CTk()

# 创建带裁剪功能的圆形Frame
circle_frame = ctk.CTkFrame(app, width=40, height=40, corner_radius=40, clip=True)
circle_frame.pack(padx=20, pady=20)

# 将图片尺寸调整为40x40，与Frame匹配
image = ctk.CTkImage(light_image=ctk.CTkImage.load("你的图片路径.png"), size=(40, 40))
# 居中放置图片标签
image_label = ctk.CTkLabel(circle_frame, image=image, text="")
image_label.place(relx=0.5, rely=0.5, anchor="center")

app.mainloop()

方式2：保留原图片尺寸，靠Frame裁剪实现圆形 #

如果不想修改图片原始尺寸，只需开启裁剪并居中图片，Frame的圆角会自动剪掉超出部分：

import customtkinter as ctk

ctk.set_appearance_mode("light")
app = ctk.CTk()

circle_frame = ctk.CTkFrame(app, width=40, height=40, corner_radius=40, clip=True)
circle_frame.pack(padx=20, pady=20)

# 保留图片50x50的原始尺寸
image = ctk.CTkImage(light_image=ctk.CTkImage.load("你的图片路径.png"), size=(50, 50))
image_label = ctk.CTkLabel(circle_frame, image=image, text="")
image_label.place(relx=0.5, rely=0.5, anchor="center")

app.mainloop()

原理说明 #

CTkFrame的clip属性控制是否裁剪子组件，开启后子组件超出Frame圆角边界的部分会被隐藏，结合居中布局，就能让图片在圆形Frame内正常显示，不会溢出。

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