wxPython 教程 (八): wxPython 高级 widgets

总目录：wxPython 教程目录 
本节内容：wxPython 高级 widgets
本节译自：zetcode
上一篇：wxPython 教程 (七): 部件 
下一篇：wxPython 教程 (九): 拖拽

动态语言使用简单，非常便于原型设计、内部开发以及学习编程。如果需要快速的解决方案或者在短期内就会更改的应用，使用动态语言更优于编译语言。相反，如果我们开发资源密集型应用、游戏以及高质量多媒体应用，那么使用 C 是最正确的选择。
本节，主要讲解多个 wxPython 高级 widgets 。wxPython 有很多有名的高级 widgets, 比如 树形 widget、HTML 窗口、 网格 widget、列表框 widget 甚至具有高级样式编排能力的编辑器 widget。

wx.ListBox

wx.ListBox 用来展示和操作一组列表项，正如其名所示，它有一个矩形框，里面有一组字符串。我们可以用它来展示一列 MP3 文件、书名、大项目的模块名或者一堆朋友的名字。 wx.ListBox 可以有两种形式，一种单选一种多选，单选是默认形式。wx.ListBox 有两个可触发事件，一个是 wx.EVT_COMMAND_LISTBOX_SELECTED 事件，当我们选择列表中的一个字符串时会触发这一事件；另一个是 wx.EVT_COMMAND_LISTBOX_DOUBLE_CLICKED，当我们双击一个条目时会触发该事件。wx.ListBox 中条目的个数在 GTK 平台是有限制的，根据文档，大概是 2000 左右，需要滚动时会自动展示滚动条。

wx.ListBox widget 构造函数如下：

其中有一个 choices 选项，可以作为展示的 list，默认为空。

在我们的例子中，有 1 个 listbox 和 4 个 buttons，每个 button 对应一个不同的方法。调用 Append() 方法可以在列表中增加条目， Delete() 可以删除条目， Clear() 可以清空条目。

我们创建了一个空的 wx.ListBox，边框是 20px。

我们绑定了 使用 wx.EVT_LISTBOX_DCLICK 绑定器将 wx.EVT_COMMAND_LISTBOX_DOUBLE_CLICKED 事件绑定至 OnRename() 方法。当用户双击特定元素时将弹出一个重命名对话框。

点击 New 按钮时，NewItem() 被调用，将展示一个 wx.GetTextFromUser 对话框，该对话框返回用户的输入。如果输入非空，我们使用 Append() 将其添加至 listbox。

删除一个 item 分两步。首先使用 GetSelection() 获取被选择条目的 index，然后将 index 作为参数传入 Delete() 方法删除该元素。

wx.ListBox 部件没有 Rename() 方法，所以我们删除之前选择的字符串，然后在原来的地方插入一个新的字符串。

清空 listbox 比较简单，我们简单调用 Clear() 即可。

图：wx.ListBox 部件

wx.html.HtmlWindow 部件

wx.html.HtmlWindow 部件可以展示 HTML 页面，它不是一个完整成熟的浏览器，但我们可以使用它做很多有意思的事情。

图：wx.ListBox 部件

Help 窗口

我们可以使用 wx.html.HtmlWindow 提供帮助窗口，该窗口可以是一个独立的 window 或者是应用的一部分。下面的例子展示了后者的使用：

开始时，帮助窗口是隐藏的，点击工具栏的帮助页面或者按 F1 键，即可在右侧显示帮助窗口，点击关闭按钮可以关闭帮助窗口。

我们竖直分割出一个 panel, 然后调用 Unsplit() 方法，该方法会默认隐藏右侧或底部的窗格。
我们将右侧的 panel 划分为 2 个部分，即 header 和 body。头部包含静态文本和一个 bitmap 按钮， body 部分则放置了一个 wx.html.Window。

该 bitmap 按钮的 style 被设置为 wx.NO_BORDER，背景色被设置为 header panel 的颜色，这样可以使得该按钮看起来属于 header 的一部分。

在右侧，我们新建了一个 wx.html.HtmlWindow 部件，HTML 代码被放置在单独的文件中，使用 LoadPage() 方法获取 HTML 代码。

我们让左侧面板获取焦点，为了能让键盘控制窗口（F1 打开帮助窗口），它必须拥有焦点。

调用 OnHelp() 可以竖直分出两个 panel，从而显示出 帮助窗口，别忘了让左侧的 panel 聚焦，因为分割窗口会让它失去初始的焦点。

下面是我们的应用中载入的 html 页面。

上面的语句，我通常会写成

，但 wx.html.HtmlWindow 仅支持标准 HTML 标记的一部分子集，需要注意。

图：帮助窗口

wx.ListCtrl 部件

wx.ListCtrl 是一列条目的图形展示部件。 wx.ListBox 尽可以展示一列内容，而 wx.ListCtrl 则可以展示多列。wx.ListCtrl 是一个非常常见和有用的窗口部件。比如一个文件管理器使用 wx.ListCtrl 可以展示文件系统的文件夹和文件，一个 CD 刻录软件使用该部件展示将被刻录到 CD 的文件。

wx.ListCtrl 有三种不同的使用格式：列表视图、报告视图和图标视图，分别通过 style 参数：wx.LC_REPORT、wx.LC_LIST 和 wx.LC_ICON 来控制。

详尽的 style 包括：

• wx.LC_LIST
• wx.LC_REPORT
• wx.LC_VIRTUAL
• wx.LC_ICON
• wx.LC_SMALL_ICON
• wx.LC_ALIGN_LEFT
• wx.LC_EDIT_LABELS
• wx.LC_NO_HEADER
• wx.LC_SORT_ASCENDING
• wx.LC_SORT_DESCENDING
• wx.LC_HRULES
• wx.LC_VRULES

简单例子

第一个例子我们首先减少了 wx.ListCtrl 的基本功能。

我们使用 wx.LC_REPORT style 新建了一个 wx.ListCtrl。

上面的代码插入了 3 列，可以单独控制每一列的宽度和格式，默认的格式是 wx.LIST_FORMAT_LEFT。

我们使用两种方法将数据插入到 wx.ListCtrl 中去。对每一行，首先调用 InsertStringItem() 方法，第一个参数为行号，使用 sys.maxint 可以保证每次调用时插入的行在上次插入行之后。该方法返回行的索引值。通过 SetStringItem() 方法可以在当前行的后续列中插入数据。

Mixins

Mixins 是可以增强 wx.ListCtrl 功能的 class。Mixin 类也叫做 helper 类，位于 wx.lib.mixins.listctrl 模块。编码人员必须继承这些类才可使用它们。
2.8.1.1 版本中，有 5 个可用的 mixins:

• wx.ColumnSorterMixin
• wx.ListCtrlAutoWidthMixin
• wx.ListCtrlSelectionManagerMix
• wx.TextEditMixin
• wx.CheckListCtrlMixin

wx.ColumnSorterMixin 可以在 report 试图中允许排序， wx.ListCtrlAutoWidthMixin 可以自动的调整 wx.ListCtrl 最后一列的宽度。默认情况下，最后一列不会占用剩余的空间，参考之前的例子。 wx.ListCtrlSelectionManagerMix 定义了独立于平台的选择策略。wx.TextEditMixin 可以允许文本编辑。wx.CheckListCtrlMixin 为每一行添加一个选择框，这样我们可以进行更多的操作。

下面的代码展示如何使用 ListCtrlAutoWidthMixin。

我们对前面的例子稍微修改了下。

这里我们导入了 mixin。

我们创建了一个新的 AutoWidthListCtrl 类，这个类继承自 wx.ListCtrl 和 ListCtrlAutoWidthMixin，这称作多重继承。最后一列会自动改变宽度来占用剩余的空间。

图：自适应宽度例子

在下面的例子中，我们展示如何创建可排序的列。当点击列头时，对应的内容将被排序。

我们仍然使用 actresses 的例子。

ColumnSorterMixin 接受一个参数，即要排序的列的个数。

必须将我们的数据匹配到 itemDataMap 属性中，且数据类型为字典。

必须新建一个 GetListCtrl() 方法，它会返回一个将被排序的 wx.ListCtrl 部件。

还需要使用 SetItemData() 方法将每一行与一个 index 关联起来。

Reader

这是一个复杂的例子，使用 report view 展示两个 list control。

上面的例子展示了一个 report 试图的 wx.ListCtrl。没有 headers，我们需要新建自己的 headers。该应用中有两个 wx.ListCtrl 分别位于左侧和右侧。

splitter 将主窗口竖直划分为两个部分，这两个 panel 各自又有两个 panel，分别作 Feeds 和 Articles 的 headers，剩余的空间则作为 listctrl 的位置。

我们给 ListCtrlRight 一个名字“ListControlOnRight”，因为后续我们需要两个部件的交互。

上面的代码位于 ListCtrlLeft 类中，我们定位了 ListCtrlRight 部件，并调用它的 LoadData() 方法。

LoadData() 方法首先清除所有的条目，然后从全局定义的文章列表中插入文章名，index 同时也被传入。

两个 wx.ListCtrl 都只有一列，这里我们让列宽度与父部件的宽度一致，否则界面将不太好看为什么要减去 5px 呢？这是一个神奇数字，如果我们减 5px，水平的滚动条就不会出现。在其他平台上，该数字可能会有变化。

图：Reader

CheckListCtrl

应用中经常会看到在一个列表部件中出现单选框，比如打包应用 Synaptic 或者 KYUM。

从编程者的思维出发，这些单选框只是简单的图片，有两种不同的状态：选择、未选择，对应两种不同的图片。我们无需亲自去实现上述功能，这已经在 CheckListCtrlMixin 中被实现。

图：Repository

wxPython 允许多重继承，这里我们继承了 3 个不同的类。

在上面的代码中，我们看到了多重继承的实际操作。对 self.list 对象，我们调用了 2 个来自不同类的方法， GetItemCount() 方法来源于 CheckListCtrl 类，CheckItem() 方法来源于 CheckListCtrlMixin 类。

在本节中，我们讲解了多个 wxPython 的高级部件。

---

上一节：wxPython 教程 (七): 部件                           下一节：wxPython 教程 (九): 拖拽