wxPython：如何为wx.Notebook标签页添加单独提示框

嘿，这个问题我之前折腾wxPython的时候也碰到过！wx.Notebook的AddPage()确实只返回成功与否的布尔值，但其实解决这个问题的关键在于你已经握有每个标签页对应的窗口对象（比如你用来作为页面的wx.Panel），或者可以通过Notebook的API轻松获取到它们。下面给你两种贴合不同需求的可行方案：

方案1：鼠标悬停在页面内容上时显示提示（简单直接） #

如果你的需求是用户把鼠标放在页面区域就能看到提示，那根本不用绕弯子——你在创建每个页面（比如wx.Panel实例）的时候，直接给它设置Tooltip就行，之后再把这个页面传给AddPage()。示例代码如下：

import wx

class DemoFrame(wx.Frame):
    def __init__(self, parent):
        super().__init__(parent, title="页面提示demo", size=(400, 300))
        
        self.notebook = wx.Notebook(self)
        # 隐藏标签栏
        self.notebook.SetWindowStyle(self.notebook.GetWindowStyle() & ~wx.NB_TABS)
        
        # 创建第一个页面并设置提示
        page1 = wx.Panel(self.notebook)
        page1.SetToolTip("这个页面用来展示用户的个人信息")
        self.notebook.AddPage(page1, "用户页")
        
        # 创建第二个页面并设置提示
        page2 = wx.Panel(self.notebook)
        page2.SetToolTip("这里可以调整系统的各项参数")
        self.notebook.AddPage(page2, "设置页")
        
        # 布局
        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(self.notebook, 1, wx.EXPAND | wx.ALL, 5)
        self.SetSizer(sizer)

if __name__ == "__main__":
    app = wx.App()
    frame = DemoFrame(None)
    frame.Show()
    app.MainLoop()

这种方案的优势是代码少、易维护，缺点是提示只会在鼠标落在页面内容上时触发，如果你需要的是在原来标签栏的位置显示提示（哪怕标签已经隐藏），那得用下面的方案。

方案2：在隐藏的标签区域显示对应页面的提示 #

因为标签栏被隐藏后，Notebook默认不会处理该区域的Tooltip事件，所以我们需要自己捕获鼠标移动事件，判断用户是否悬停在某个标签的位置，然后显示对应的提示。步骤如下：

1. 给每个页面设置Tooltip（或者用一个列表存储各页面的提示文本）；
2. 给Notebook绑定wx.EVT_MOTION事件，在事件处理函数中用HitTest()方法判断鼠标位置对应的页面索引；
3. 根据索引显示对应的提示，离开标签区域则清空提示。

完整代码示例：

import wx

class DemoFrame(wx.Frame):
    def __init__(self, parent):
        super().__init__(parent, title="隐藏标签栏的提示demo", size=(400, 300))
        
        self.notebook = wx.Notebook(self)
        # 隐藏标签栏
        self.notebook.SetWindowStyle(self.notebook.GetWindowStyle() & ~wx.NB_TABS)
        
        # 创建页面并设置各自的提示
        page1 = wx.Panel(self.notebook)
        page1.SetToolTip("用户信息展示页，包含头像、昵称等内容")
        self.notebook.AddPage(page1, "用户页")
        
        page2 = wx.Panel(self.notebook)
        page2.SetToolTip("系统参数设置页，可调整语言、主题等")
        self.notebook.AddPage(page2, "设置页")
        
        # 绑定鼠标移动事件，处理提示逻辑
        self.notebook.Bind(wx.EVT_MOTION, self.on_notebook_mouse_move)
        
        # 布局
        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(self.notebook, 1, wx.EXPAND | wx.ALL, 5)
        self.SetSizer(sizer)
        
    def on_notebook_mouse_move(self, event):
        # HitTest返回(index, flags)，index为页面索引，-1表示不在标签区域
        page_index, _ = self.notebook.HitTest(event.GetPosition())
        
        if page_index != wx.NOT_FOUND:
            # 获取对应页面的提示文本
            target_page = self.notebook.GetPage(page_index)
            tip_text = target_page.GetToolTipText()
            if tip_text:
                self.notebook.SetToolTip(tip_text)
            else:
                self.notebook.UnsetToolTip()
        else:
            # 离开标签区域，清空提示
            self.notebook.UnsetToolTip()
            
        # 必须调用Skip()，否则其他控件的鼠标事件会被拦截
        event.Skip()

if __name__ == "__main__":
    app = wx.App()
    frame = DemoFrame(None)
    frame.Show()
    app.MainLoop()

关键说明 #

HitTest()方法即使在标签栏被隐藏的情况下，依然能准确检测到鼠标是否位于某个标签的原始位置——因为Notebook内部还是保留了标签区域的布局信息，所以这个方法可以完美实现我们的需求。

如果你不想给每个页面绑定Tooltip，也可以用一个列表来存储所有页面的提示文本，比如self.page_tips = ["用户页提示", "设置页提示"]，然后在事件处理中直接取self.page_tips[page_index]即可。

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