wxPython中wx.ListCtrl用法（二）

wx.ListCtrl是一个列表组件，可以以列表视图（list view）、报表视图（report view）、图标视图（icon view）和小图标视图（small icon view）等多种模式显示列表。

一、方法

__init__ (self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, name=ListCtrlNameStr)

构造函数

参数

parent – 父窗体。不能为空（None）。

id – 列表组件标识符。默认值为wx.ID_ANY(-1)，表示由系统自动分配一个唯一标识符。

pos – 列表组件位置。

size – 列表组件大小。

style – 列表组件样式。

name – 列表组件名称。

创建列表组件

Append(self, entry)

在列表组件框内末尾追加项目。

参数

entry – 待追加的项目实体（包含项目每一列内容的数组、元组等序列）。

返回值

返回追加项目的索引。

追加项目

AppendColumn(self, heading, format=LIST_FORMAT_LEFT, width=-1)

列表组件框中追加列。

参数

heading – 列表头。

 format – 格式样式。

width – 列宽。

返回值

返回追加列索引。

追加列

AssignImageList(self, imageList, which)

设置列表组件的关联图像列表。

参数

imageList – 图像列表。

which – 图像样式。

设置项目图标

CheckItem(self, item, check=True)

选中或取消选中项目（列表组件框需要调用EnableCheckBoxes 函数，开启项目选择功能）。

参数

item – 项目索引（从0开始）。

check – 是否选中项目，True选中，False不选中。

选中项目

ClearAll(self)

清空列表组件框（删除所有项目和列），同时触发wx.EVT_LIST_DELETE_ALL_ITEMS 事件。

清空列表组件内容

DeleteAllColumns(self)

删除列表组件所有列以及列下的数据。

返回

所有列都被删除返回True，否则返回False。

删除列

DeleteAllItems(self)

删除列表组件框所有项目，同时触发wx.EVT_LIST_DELETE_ALL_ITEMS事件。

返回

所有项目都被删除返回True，否则返回False。

删除所有项目

DeleteColumn(self, col)

删除列表组件框中的指定列以及列下数据。

参数

col – 列索引（从0开始）。

返回

删除成功返回True，否则False。

删除列

DeleteItem(self, item)

删除列表组件框中指定项目。

参数

item – 项目索引（从0开始）。

返回

删除成功返回True，否则False。

删除项目（行）

EditLabel(self, item)

程序手动开启指定项目编辑功能，并触发wx.EVT_LIST_BEGIN_LABEL_EDIT事件（需要列表组件有wx.LC_EDIT_LABELS样式）。

参数

item – 项目索引（从0开始）。

返回

指定索引项目存在返回待编辑的wx.TextCtrl对象，不存在返回None。

程序手动开启项目编辑

EnableCheckBoxes(self, enable=True)

是否显示项目前面的复选框。

参数

enable – 是否显示复选框（True显示复选框，False不显示）。

返回

设置成功返回True，否则返回False。

显示项目复选框

FindItem (self, start, str, partial=False)

查找项目。

参数

start – 开始查找项目的索引（包含该索引指向的项目）。

str – 查找文本。

partial – 匹配模式，False精确匹配项目文本，True匹配以查找字符串开头的项目文本。

返回

如果找到返回找到的项目索引，没有找到返回-1。

查找项目

GetColumn(self, col)

获取列信息。

参数

col – 列索引（从0开始）。

返回

如果存在指定索引的列返回wx.ListItem（保存列信息的对象）,不存在返回None。

获取列信息

GetColumnCount(self)

获取列数。

返回

返回列数。wx.LC_REPORT样式下按实际列数返回，wx.LC_LIST样式返回1，wx.LC_SMALL_ICON和wx.LC_ICON样式返回0。

获取列数

GetColumnIndexFromOrder(self, pos)

按图形界面展示的顺序位置获取列的索引（Windows系统下有效）。

参数

 pos – 图形界面展示顺序位置（从0开始）。

返回

返回列索引。

列索引

GetColumnOrder(self, col)

根据列索引获取图形界面展示的顺序位置。

参数

col – 列索引。

返回

返回图形界面展示顺序位置（从0开始）。

根据列索引获取图形界面展示的顺序位置

GetColumnWidth(self, col)

根据列索引获取列宽度。

参数

col – 列索引。

返回

返回列宽度。

列宽度

GetColumnsOrder(self)

获取图形界面展示的顺序位置。

返回

返回图形界面展示的顺序位置。

界面展示顺序

GetCountPerPage(self)

获取列表组件可见区域能容纳的项目（行）数。

返回

返回列表组件可见区域能容纳的项目（行）数。

显示行数

GetEditControl(self)

获取当前可编辑项目框组件。

返回

返回当前可编辑项目框组件（如果当前没有可编辑框返回None）。

获取编辑框

GetFirstSelected(self)

返回第一个选中项的索引。

返回

返回第一个选中项的索引（即索引最小的选中项的索引）（从0开始），如果没有选中项返回-1。

获取选中项目索引

GetFocusedItem(self)

返回焦点所在项的索引。

返回

返回焦点所在项的索引（从0开始），如果焦点不在任何项上返回-1。

获取焦点所在项索引

作者：沿着缘溪奔向大海