wxPython - ListBox & ListCtrl 类

上一页
下一页

wx.ListBox 小部件呈现一个垂直可滚动的字符串列表。默认情况下，列表中只能选择一个项目。但是，它可以自定义为多选。

ListCtrl 小部件是一个高度增强的列表显示和选择工具。在报表视图、列表视图或图标视图中可以显示多个列的列表。

ListBox 构造函数具有以下定义：

Wx.ListBox(parent, id, pos, size, choices, style)

Choices 参数是用于填充列表的字符串列表。

wx.ListBox 对象可以使用以下样式参数进行自定义：

序号 参数 & 描述
1

wxLB_SINGLE

单选列表
2

wxLB_MULTIPLE

多选列表：用户可以切换多个项目的选中状态
3

wxLB_EXTENDED

扩展选择列表 - 用户可以通过使用 SHIFT 或 CTRL 键以及光标移动键或鼠标来扩展选择范围
4

wxLB_HSCROLL

如果内容过宽，则创建水平滚动条
5

wxLB_ALWAYS_SB

始终显示垂直滚动条
6

wxLB_NEEDED_SB

仅在需要时创建垂直滚动条
7

wxLB_SORT

列表框内容按字母顺序排序

wx.ListBox 类方法：

序号 方法 & 描述
1

DeSelect()

取消选择列表框中的一个项目
2

InsertItem()

在指定位置插入给定的字符串
3

SetFirstItem()

将给定索引处的字符串设置为列表中的第一个
4

IsSorted()

如果使用了 wxzL?B_SORT 样式，则返回 true
5

GetString()

返回选定索引处的字符串
6

SetString()

设置给定索引处项目的标签

EVT_LISTBOX 绑定器在列表中的某个项目被选中或程序化地更改选择时触发处理程序。当列表框项目上发生双击事件时，由 EVT_LISTBOX_DCLICK 绑定的处理程序函数被调用。

示例

在以下示例中，ListBox 控件和 TextCtrl 对象分别放置在水平框调整器左侧和右侧部分。ListBox 使用 languages[] 列表对象中的字符串填充。

languages = ['C', 'C++', 'Java', 'Python', 'Perl', 'JavaScript','PHP','VB.NET','C#'] 
self.text = wx.TextCtrl(panel,style = wx.TE_MULTILINE) 
lst = wx.ListBox(panel, size = (100,-1), choices = languages, style = wx.LB_SINGLE)

两个对象放置在水平框调整器中。

box = wx.BoxSizer(wx.HORIZONTAL) 
box.Add(lst,0,wx.EXPAND) 
box.Add(self.text, 1, wx.EXPAND)

ListBox 控件使用 EVT_LISTBOX 绑定器链接到 onListBox() 处理程序。

self.Bind(wx.EVT_LISTBOX, self.onListBox, lst)

处理程序将选定的字符串追加到右侧的多行 TextCtrl 中。

def onListBox(self, event): 
   self.text.AppendText( "Current selection: "+ 
      event.GetEventObject().GetStringSelection() + "\n")

完整代码如下：

import wx 
class Mywin(wx.Frame): 
            
   def __init__(self, parent, title): 
      super(Mywin, self).__init__(parent, title = title,size = (350,300))
		
      panel = wx.Panel(self) 
      box = wx.BoxSizer(wx.HORIZONTAL) 
		
      self.text = wx.TextCtrl(panel,style = wx.TE_MULTILINE) 
         
      languages = ['C', 'C++', 'Java', 'Python', 'Perl', 'JavaScript', 'PHP', 'VB.NET','C#']   
      lst = wx.ListBox(panel, size = (100,-1), choices = languages, style = wx.LB_SINGLE)
		
      box.Add(lst,0,wx.EXPAND) 
      box.Add(self.text, 1, wx.EXPAND) 
		
      panel.SetSizer(box) 
      panel.Fit() 
		
      self.Centre() 
      self.Bind(wx.EVT_LISTBOX, self.onListBox, lst) 
      self.Show(True)  
		
   def onListBox(self, event): 
      self.text.AppendText( "Current selection: 
         "+event.GetEventObject().GetStringSelection()+"\n")
		
ex = wx.App() 
Mywin(None,'ListBox Demo') 
ex.MainLoop()

以上代码产生以下输出：

Listbox Demo

wx.ListCtrl 是一个增强的，因此更复杂的小部件。ListBox 仅显示一列，而 ListCtrl 可以包含多列。ListCtrl 小部件的外观由以下样式参数控制：

序号 参数 & 描述
1

wx.LC_LIST

多列列表视图，带可选的小图标。列自动计算
2

wx.LC_REPORT

单列或多列报表视图，带可选的标题
3

wx.LC_VIRTUAL

应用程序根据需要提供项目文本。只能与 wxLC_REPORT 一起使用
4

wx.LC_ICON

大图标视图，带可选标签
5

wx.LC_SMALL_ICON

小图标视图，带可选标签
6

wx.LC_ALIGN_LEFT

图标左对齐
7

wx.LC_EDIT_LABELS

标签可编辑 - 应用程序将在编辑开始时收到通知
8

wx.LC_NO_HEADER

报表模式下没有标题
9

wx.LC_SORT_ASCENDING

升序排序
10

wx.LC_SORT_DESCENDING

降序排序
11

wx.LC_HRULES

在报表模式下，在行之间绘制浅色水平线
12

wx.LC_VRULES

在报表模式下，在列之间绘制浅色垂直线

示例

在以下示例中构造了一个报表视图中的 ListCtrl 小部件。

self.list = wx.ListCtrl(panel, -1, style = wx.LC_REPORT)

标题列由 InsertColumn() 方法创建，该方法采用列号、标题、样式和宽度参数。

self.list.InsertColumn(0, 'name', width = 100) 
self.list.InsertColumn(1, 'runs', wx.LIST_FORMAT_RIGHT, 100) 
self.list.InsertColumn(2, 'wkts', wx.LIST_FORMAT_RIGHT, 100)

一个元组列表，每个元组包含三个字符串，称为 players[]，存储用于填充 ListCtrl 对象列的数据。

新行以 InsertStringItem() 方法开头，该方法返回当前行的索引。使用 sys.maxint 会在最后一行之后给出行号。使用该索引，其他列由 SetStringItem() 方法填充。

for i in players: 
   index = self.list.InsertStringItem(sys.maxint, i[0]) 
   self.list.SetStringItem(index, 1, i[1]) 
   self.list.SetStringItem(index, 2, i[2])

该示例的完整代码如下：

import sys 
import wx  

players = [('Tendulkar', '15000', '100'), ('Dravid', '14000', '1'), 
   ('Kumble', '1000', '700'), ('KapilDev', '5000', '400'), 
   ('Ganguly', '8000', '50')] 
	
class Mywin(wx.Frame): 
            
   def __init__(self, parent, title): 
      super(Mywin, self).__init__(parent, title = title) 
		
      panel = wx.Panel(self) 
      box = wx.BoxSizer(wx.HORIZONTAL)
		
      self.list = wx.ListCtrl(panel, -1, style = wx.LC_REPORT) 
      self.list.InsertColumn(0, 'name', width = 100) 
      self.list.InsertColumn(1, 'runs', wx.LIST_FORMAT_RIGHT, 100) 
      self.list.InsertColumn(2, 'wkts', wx.LIST_FORMAT_RIGHT, 100) 
         
      for i in players: 
         index = self.list.InsertStringItem(sys.maxint, i[0]) 
         self.list.SetStringItem(index, 1, i[1]) 
         self.list.SetStringItem(index, 2, i[2]) 
			
      box.Add(self.list,1,wx.EXPAND) 
      panel.SetSizer(box) 
      panel.Fit() 
      self.Centre() 
         
      self.Show(True)  
     
ex = wx.App() 
Mywin(None,'ListCtrl Demo') 
ex.MainLoop()

以上代码产生以下输出。球员数据以报表视图显示：

Listctrl Demo Output
wxpython_major_classes.htm
打印页面
上一页
下一页
广告