如何在 tk.Frame 中正确嵌入 ttk.Notebook 控件

霞舞 2026-01-21 00:00:00 次阅读

本文详解如何将 `ttk.notebook` 成功添加到 `tk.frame` 中：需先实例化 notebook，再通过 `pack`/`grid`/`place` 布局管理器将其挂载到目标 frame，最后调用 `add()` 方法插入带标签的子页（frame 或其他容器）。

要在 tk.Frame（如示例中的 self.frame0）中嵌入 ttk.Notebook，关键在于两步不可省略：

创建 Notebook 实例并显式布局（仅 ttk.Notebook(self.frame0) 不会自动显示，必须调用 pack()、grid() 或 place()）；
为每个 Tab 创建独立容器（推荐 tk.Frame），再用 .add() 方法注册到 Notebook。

以下是完整可运行的修改示例（基于原代码）：

import tkinter as tk
from tkinter import ttk

class MyApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("hello world")

        # 创建两个主 Frame
        self.frame0 = tk.Frame(self, background="green")
        self.frame1 = tk.Frame(self, background="blue")

        self.frame0.pack(side="top", fill="both", expand=True)
        self.frame1.pack(side="top", fill=tk.X, expand=True)

        # === 在 frame0 中添加 Notebook ===
        self.tabControl = ttk.Notebook(self.frame0)
        self.tabControl.grid(row=0, column=0, sticky="nsew", padx=5, pady=5)

        # 配置 grid 权重，确保 Notebook 自适应大小
        self.frame0.grid_rowconfigure(0, weight=1)
        self.frame0.grid_columnconfigure(0, weight=1)

        # 创建 Tab 页面（每个都是独立 Frame）
        self.tab1 = tk.Frame(self.tabControl, relief="sunken", bd=1)
        self.tab2 = tk.Frame(self.tabControl, relief="sunken", bd=1)

        # 添加 Tab 到 Notebook
        self.tabControl.add(self.tab1, text="Tab 0")
        self.tabControl.add(self.tab2, text="Tab 1")

        # 可选：在 Tab 内添加内容（例如标签）
        tk.Label(self.tab1, text="This is Tab 0 content").pack(pady=20)
        tk.Label(self.tab2, text="This is Tab 1 content").pack(pady=20)

        # frame1 保持不变
        self.frame1_label0 = tk.Label(self.frame1, text="OTHER")
        self.frame1_label0.grid(row=0, column=0)

def main():
    MyApp().mainloop()

if __name__ == "__main__":
    main()

? 重要注意事项：

✅ 必须为 self.frame0 启用 grid_rowconfigure() 和 grid_columnconfigure()（或使用 pack(fill='both', expand=True)），否则 Notebook 可能无法填充可用空间；
✅ 每个 Tab 必须是独立的容器（如 tk.Frame），不能直接传入控件；
⚠️ 避免混用布局管理器：若 frame0 使用 grid()，则 Notebook 也应使用 grid()；若 frame0 使用 pack()，则 Notebook 应用 pack() 并注意 expand=True；
? ttk.Notebook 默认无背景色，可通过 style 自定义外观（如设置 tab 背景、字体等），但基础功能无需额外配置。

通过以上方式，你就能在任意 tk.Frame 中灵活集成多标签界面，实现模块化、可扩展的 GUI 结构。