使用wxpython开发跨平台桌面应用，动态工具的创建处理

余培毓

在我们开发系统的时候，往往需要一个很容易理解功能的工具栏，工具栏是一个系统的快速入口，美观易用的工具栏是可以给系统程序增色不少的，本篇随笔介绍在使用wxpython开发跨平台桌面应用，工具栏的动态展现效果，以及多级工具栏显示等的创建处理过程。
1、wxpython工具栏介绍

在 wxPython 中，工具栏（Toolbar） 是一种常用的 GUI 组件，用于显示一系列图标按钮，提供用户快速访问常用功能。
wxPython 中的工具栏可以使用 wx.ToolBar 类来创建和管理。wxPython 还提供了 wx.adv.ToolBar 组件，支持更丰富的界面元素和布局功能。根据用户需求可以选择使用。
另外在 wxPython 中，wx.aui.AuiToolBar 是 高级用户界面库（Advanced User Interface，AUI） 中的工具栏组件，提供了更灵活和可自定义的工具栏功能。相较于传统的 wx.ToolBar，AuiToolBar 支持拖放、浮动、隐藏等高级特性，适合开发更复杂的 GUI 应用。
（MacOS系统表现界面）

 本篇随笔主要介绍基于wx.aui.AuiToolBar 来及进行工具栏界面的创建处理，以上图形就是基于wx.aui.AuiToolBar 来进行创建的。
1）. 主要特性

• 拖放支持：可以通过拖动工具栏，将其停靠到不同的位置。
  
• 可自定义样式：支持文本、图标、分隔符、下拉菜单等多种样式。
  
• 可隐藏与显示：用户可以根据需要显示或隐藏工具栏。
  
• 可浮动：工具栏可以作为独立窗口浮动。
  

2）. 基础示例

以下是一个使用 wx.aui.AuiToolBar 的基本示例：

1. import wx
2. import wx.aui
4. class MyFrame(wx.Frame):
5.     def __init__(self, *args, **kw):
6.         super().__init__(*args, **kw)
8.         # 创建 AUI 管理器
9.         self.mgr = wx.aui.AuiManager(self)
11.         # 创建 AuiToolBar
12.         toolbar = wx.aui.AuiToolBar(self, style=wx.aui.AUI_TB_DEFAULT_STYLE | wx.aui.AUI_TB_OVERFLOW)
14.         # 添加工具按钮
15.         open_bmp = wx.ArtProvider.GetBitmap(wx.ART_FILE_OPEN, wx.ART_TOOLBAR)
16.         save_bmp = wx.ArtProvider.GetBitmap(wx.ART_FILE_SAVE, wx.ART_TOOLBAR)
17.         exit_bmp = wx.ArtProvider.GetBitmap(wx.ART_QUIT, wx.ART_TOOLBAR)
19.         toolbar.AddTool(wx.ID_OPEN, "Open", open_bmp, short_help="Open File")
20.         toolbar.AddTool(wx.ID_SAVE, "Save", save_bmp, short_help="Save File")
21.         toolbar.AddSeparator()  # 添加分隔符
22.         toolbar.AddTool(wx.ID_EXIT, "Exit", exit_bmp, short_help="Exit Application")
24.         # 完成工具栏布局
25.         toolbar.Realize()
27.         # 将工具栏添加到 AUI 管理器
28.         self.mgr.AddPane(toolbar, wx.aui.AuiPaneInfo().Name("Toolbar").Top().Dockable(True))
30.         # 绑定事件
31.         self.Bind(wx.EVT_TOOL, self.on_open, id=wx.ID_OPEN)
32.         self.Bind(wx.EVT_TOOL, self.on_save, id=wx.ID_SAVE)
33.         self.Bind(wx.EVT_TOOL, self.on_exit, id=wx.ID_EXIT)
35.         # 设置窗口
36.         self.SetSize((600, 400))
37.         self.Centre()
38.         self.mgr.Update()  # 更新 AUI 管理器
40.     def on_open(self, event):
41.         wx.MessageBox("Open clicked", "Info", wx.OK | wx.ICON_INFORMATION)
43.     def on_save(self, event):
44.         wx.MessageBox("Save clicked", "Info", wx.OK | wx.ICON_INFORMATION)
46.     def on_exit(self, event):
47.         self.Close()
49.     def OnClose(self, event):
50.         self.mgr.UnInit()  # 清理 AUI 管理器
51.         self.Destroy()
53. class MyApp(wx.App):
54.     def OnInit(self):
55.         frame = MyFrame(None, title="wxPython AuiToolBar Example")
56.         frame.Show()
57.         return True
59. if __name__ == "__main__":
60.     app = MyApp()
61.     app.MainLoop()

复制代码

3）. 主要方法与属性

• AddTool(id, label, bitmap, short_help="", long_help="")：向工具栏添加工具按钮。
  
• AddSeparator()：添加分隔符。
  
• AddControl(control)：向工具栏添加一个控件，如文本框、下拉框等。
  
• Realize()：确认并显示工具栏布局。
  
• SetToolDropDown(id, enable=True)：为工具按钮启用下拉菜单功能。
  

4）. 常用样式

wx.aui.AuiToolBar 提供了一些样式选项，可以灵活控制工具栏的外观和行为：

• AUI_TB_TEXT：显示按钮文本。
  
• AUI_TB_NO_TOOLTIPS：不显示工具提示。
  
• AUI_TB_HORZ_LAYOUT：水平布局，文本在图标右侧。
  
• AUI_TB_PLAIN_BACKGROUND：使用简单背景，不使用默认渐变效果。
  
• AUI_TB_OVERFLOW：启用溢出按钮，用于显示更多按钮。
  

wx.aui.AuiToolBar 支持添加自定义控件，例如下拉框、文本框等，可以为工具按钮添加下拉菜单功能。
AUI 的工具栏可以动态更新，比如禁用、启用、添加、移除工具按钮：
5）、AUI 管理器与工具栏

AuiManager 负责管理所有 AUI 组件，工具栏也是其中之一。可以通过 AuiPaneInfo 配置工具栏的停靠位置、浮动、隐藏等特性：

1. pane_info = wx.aui.AuiPaneInfo().Name("Toolbar").Top().Caption("Main Toolbar").Floatable(True)
2. self.mgr.AddPane(toolbar, pane_info)

复制代码

wx.aui.AuiToolBar 提供了比标准 wx.ToolBar 更强大和灵活的功能，尤其适合需要动态布局和自定义界面的应用程序。通过 AuiManager 管理工具栏，可以轻松实现拖放、浮动、隐藏等高级界面特性，使应用程序更具可操作性和用户体验。
 
2、工具栏的折叠和二级菜单的处理

对于工具栏，我们一般需要创建一些常用的按钮，如果界面折叠，工具栏可以进行折叠到一处，方便查看，如下界面所示（MacOS系统表现界面）。

折叠效果对于不同平台的表现效果是一致的，如下是Windows下的展现效果。

 
而对于工具栏有二级或者更多功能点的处理，也需要考虑，我们可以把它们放在左侧树列表中，进行展开更多的功能。
如下所示是我在一级【权限管理系统】中存在二级菜单，因此让它打开的时候，在左侧树列表中更加直观的体现出来，如下效果所示（Windows 系统表现界面）。

 
3、系统程序的动态工具的创建处理

 上面的最终效果，我们会通过后端的数据库进行存储，动态在界面上进行展示，可以根据角色用户的权限进行分配显示即可。
为了实现这个目标，我们先定义菜单/工具栏的存储对象信息，如下所示。

1. @dataclass
2. class MenuInfo:
3.     id: str  # 菜单ID
4.     pid: str  # 父菜单ID
5.     label: str  # 菜单名称
6.     icon: str = None  # 菜单图标
7.     path: str = None  # 菜单路径，用来定位视图
8.     tips: str = None  # 菜单提示
9.     children: list["MenuInfo"] = None

复制代码

对于单个工具栏信息，如下所示。

1. MenuInfo(
2.     id="01",
3.     label="用户管理",
4.     icon="user",
5.     path="views.testaui_panel.DocumentPanel",
6. ),

复制代码

其中icon, 我们根据内置的ART_图标或者自己定义的集合图标来处理即可。而Path是用来在模块中获得窗体界面的路径，我们动态根据路径来构建界面类。
而对于主工具栏上展示的多级菜单，我们也是通过上面的类来定义嵌套的集合即可，如下所示。

1. MenuInfo(
2.     id="11",
3.     label="权限管理系统",
4.     icon="computer_key",
5.     children=[
6.         MenuInfo(
7.             id="11-1",
8.             label="用户管理",
9.             icon="user",
10.             path="views.testaui_panel.DocumentPanel",
11.         ),
12.         MenuInfo(
13.             id="11-2",
14.             label="组织机构管理",
15.             icon="organ",
16.             path="views.my_banner.BannerDialog2",
17.         ),
18.         ...
19.     ]
20. }

复制代码

在系统开发的初期，我们可以先试用模拟方式获得数据集合，如通过一个工具来来获得数据，如下所示。

以上的菜单集合，我们对接后端FastAPI+SqlAlchemy接口后，即可动态获取，有关 【后端FastAPI+SqlAlchemy接口开发】，大家可以参考随笔介绍。
基于SqlAlchemy+Pydantic+FastApi的Python开发框架的路由处理

基于SqlAlchemy+Pydantic+FastApi的Python开发框架

使用FastAPI来开发项目，项目的目录结构如何规划的一些参考和基类封装的一些处理

在使用FastAPI处理数据输入的时候，对模型数据和路径参数的一些转换处理

前面介绍了一下关于wx.aui.AuiToolBar的一些内容，我们按照上面的创建工具栏，如下代码所示。

1. def create_toolbars(self):
2.     """创建工具栏"""
3.     self.tb1 = self._create_toolbar()  # 工具栏
5.     self.mgr.AddPane(
6.         self.tb1,
7.         aui.AuiPaneInfo()
8.         .Name("ToolBar1")
9.         .Caption("工具条")
10.         .ToolbarPane()
11.         .Top()
12.         .Row(0)
13.         .Position(0)
14.         .Floatable(False),
15.     )

复制代码

其中mgr是我们的Aui界面管理类，如下定义。

1. # 初始化AuiManager，用来管理工具栏以及AuiNotebook等
2. self.mgr = aui.AuiManager(self)

复制代码

其中_create_toolbar的处理就是获得工具栏集合并动态处理的，如下代码所示。

1. toolbars =<strong> ToolbarUtil.create_tools()
2. </strong>#遍历工具栏进行处理
3. for item in toolbars:
4.     tool_id = wx.NewIdRef()
5.     help_string = item.tips if item.tips else item.label
6.     bitmap = get_bitmap(item.icon)
7. <strong>    tb.AddSimpleTool(
8.         tool_id</strong><strong>=tool_id,
9.         label=item.label,
10.         bitmap=bitmap,
11.         short_help_string=help_string,
12.     )
14.     </strong># 绑定事件
15.     self.Bind(
16.         wx.EVT_TOOL,
17.         partial(self.on_tool_event, item),  # 这里传递菜单信息
18.         id=tool_id,
19.     )

复制代码

同时我们添加一些常见的折叠、关于、关闭窗口的常用工具栏，并绑定事件处理，如下代码所示。

1. self.<strong>Bind</strong>( wx.EVT_TOOL, lambda event: EventPub.toggle_left_panel(),id=self.id_show_hide_left)
2. self.<strong>Bind</strong>( wx.EVT_TOOL, lambda event: EventPub.show_about_dialog(), id=self.id_about)
3. self.<strong>Bind</strong>( wx.EVT_TOOL, lambda event: EventPub.close_all_page(), id=self.id_close_all)
4. tb.Realize()
5. return tb

复制代码

其中对于一些全局的事件处理，我们通过pypubsub 组件进行事件的推动和接收处理。
如下代码，我们定义一个EventPub类来处理，如下代码所示。

1. from pubsub import pub
2. from entity.common import MenuInfo
4. # 定义事件处理类，统一处理事件发布接口
5. class<strong> EventPub</strong>:
6.     """事件发布者"""
8.     @staticmethod
9.     def <strong>send_event</strong>(event_name: str, data=None):
10.         """发送事件"""
11.         pub.sendMessage(event_name, data=data)
13.     @staticmethod
14.     def <strong>show_window</strong>(data: MenuInfo, hide_toolbox=True):
15.         """打开窗口"""
16.         pub.sendMessage("show_window", info=data, hide_toolbox=hide_toolbox)
18.       ......................

复制代码

在主窗体初始化的时候，我们会跟踪通过EventPub推送的事件进行处理，如下是对于窗体或者对话框的统一处理，通过动态构建视图对象，我们就可以让它显示在主界面的notbook控件里面了。

对于下面的界面，我们就是通过动态的路径进行统一的构建显示在主面板中的，效果如下所示。

当然MacOS里面的效果也是差不多的，换个窗体界面如下所示。

 

来源:https://www.cnblogs.com/wuhuacong/p/18539400
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！