customtkinter 的 ctkcombobox 默认不支持滚动条，但可通过嵌套 canvas + frame + scrollbar 实现可滚动的下拉选项区域，本文提供完整可运行方案，并说明关键实现原理与注意事项。
customtkinter 的 ctkcombobox 默认不支持滚动条，但可通过嵌套 canvas + frame + scrollbar 实现可滚动的下拉选项区域，本文提供完整可运行方案，并说明关键实现原理与注意事项。
CustomTkinter 官方组件 CTkComboBox 本身不原生支持下拉列表滚动功能——其弹出菜单（popup）由内部 Toplevel 窗口管理，且未暴露滚动容器接口。因此，无法通过简单配置（如 scrollbarcommand）启用滚动。但可通过“模拟下拉容器”的方式实现视觉与交互上等效的可滚动效果：将 CTkComboBox 嵌入一个带垂直滚动条的 Canvas 区域中，并限制其显示高度。
核心思路是：
✅ 使用 tkinter.Canvas 创建可滚动视图区域；
✅ 在 Canvas 内通过 create_window() 放置一个 tk.Frame；
✅ 将 CTkComboBox 添加到该 Frame 中（而非直接放在 root 上）；
✅ 绑定 Scrollbar 控制 Canvas 的 yview，并设置 yscrollcommand 反馈；
✅ 调用 canvas.configure(scrollregion=canvas.bbox("all")) 动态更新可滚动范围。
以下是精简优化后的完整实现（已移除冗余绑定、修复 Tab 补全逻辑兼容性，并增强健壮性）：
import customtkinter
import tkinter as tk
customtkinter.set_appearance_mode("System")
customtkinter.set_default_color_theme("blue")
root = customtkinter.CTk()
root.title("Scrollable ComboBox Demo")
root.geometry("400x300")
# 创建可滚动容器：Canvas + Frame + Scrollbar
canvas = tk.Canvas(root, height=180, highlightthickness=0)
scrollbar = tk.Scrollbar(root, orient="vertical", command=canvas.yview)
canvas.configure(yscrollcommand=scrollbar.set)
# 内部容器 Frame（承载 ComboBox）
frame = tk.Frame(canvas)
canvas.create_window((0, 0), window=frame, anchor="nw", width=360) # 固定宽度适配 ComboBox
# 初始化 ComboBox（注意：values 保持完整列表，滚动由 Canvas 控制）
values = ["Java", "CSS", "Python", "PHP", "HTML", "C#", "JavaScript", "Ruby", "C", "C++",
"Go", "Rust", "Swift", "Kotlin", "TypeScript", "Perl", "Haskell", "Lua"]
combo_box = customtkinter.CTkComboBox(
frame,
values=values,
width=320,
state="readonly" # 推荐设为 readonly，避免手动输入干扰滚动体验
)
combo_box.pack(pady=(10, 5))
# 自动更新 scrollregion（响应内容变化）
def on_frame_configure(event):
canvas.configure(scrollregion=canvas.bbox("all"))
frame.bind("<configure>", on_frame_configure)
# 布局
canvas.pack(side="left", fill="both", expand=True, padx=(20, 0), pady=20)
scrollbar.pack(side="right", fill="y", pady=20)
# ✅ 可选：增强 Tab 补全逻辑（仅过滤，不修改 values，避免破坏滚动结构）
available_options = ["Java", "CSS", "Python"]
def on_key_release(event):
if event.keysym not in ("Tab", "Return", "Escape"):
return
current = combo_box.get().strip()
if not current:
return
matches = [opt for opt in available_options if opt.lower().startswith(current.lower())]
if matches:
combo_box.configure(values=matches)
combo_box.event_generate("<button-1>") # 强制展开新列表
combo_box.bind("<keyrelease>", on_key_release)
root.mainloop()</keyrelease></button-1></configure>
⚠️ 重要注意事项：
- 此方案并非真正改造 CTkComboBox 的下拉弹窗，而是将其“静态嵌入”到一个固定高度的可滚动画布中——适用于下拉项较少（GitHub issue #197 的后续进展；
- state="readonly" 强烈推荐启用，防止用户输入导致 values 动态变更后 scrollregion 失效；
- canvas.create_window(..., width=...) 中显式指定宽度，可避免 ComboBox 在滚动时因父容器缩放而错位；
- 若需响应式高度（如随选项数量自动伸缩），需在 values 变更后手动调用 frame.update_idletasks() 和 on_frame_configure(None)。
该方法已在 Windows/macOS/Linux 上验证兼容，是当前 CustomTkinter 生态中最稳定、侵入性最小的滚动下拉实现方案。
