wx.ListCtrl是一个列表组件,可以以列表视图(list view)、报表视图(report view)、图标视图(icon view)和小图标视图(small icon view)等多种模式显示列表。
- 方法
GetImageList(self, which)
根据图像列表类型获取与列表组件框相关联的图像列表。
参数
which - 图像列表类型(wx.IMAGE_LIST_NORMAL表示大图标,wx.IMAGE_LIST_SMALL表示小图标,wx.IMAGE_LIST_STATE表示自定义图标)。
返回
返回图像列表。
获取与列表组件框相关联的图像列表
GetItem(self, itemIdx, col=0)
获取指定行、列项的对象。
参数
itemIdx - 项目(行)索引(从0开始)。
col - 列索引(从0开始)。
返回
返回指定项目对象。
获取指定项目
GetItemBackgroundColour(self, item)
获取指定项目(行)的背景色。
参数
item - 项目索引(从0开始)。
返回
返回背景颜色对象。
获取项目背景色
GetItemCount(self)
返回项目数。
返回
返回项目数。
获取项目(行)数
GetItemData(self, item)
获取指定项目(行)关联的数据。
参数
item - 项目索引(从0开始)。
返回
返回指定项目关联的数据。
获取项目数据
GetItemFont(self, item)
获取指定项目(行)关联的数据。
参数
item - 项目索引(从0开始)。
返回
返回指定项目的字体对象。
获取字体对象
GetItemPosition(self, item)
获取指定项目(行)关联的位置。
参数
item - 项目索引(从0开始)。
返回
返回指定项目的位置对象。
获取项目位置对象
GetItemText(self, itemidx, col=0)
获取指定行、列项的文本内容。
参数
itemIdx - 项目(行)索引(从0开始)。
col - 列索引(从0开始)。
返回
返回指定项目文本内容。
获取第2行,第2列项目文本内容
GetItemTextColour(self, item)
获取指定项目(行)文本颜色。
参数
item - 项目(行)索引(从0开始)。
返回
返回指定项目文本颜色。
获取第2行文本颜色
GetNextItem(self, item, geometry=LIST_NEXT_ALL, state=LIST_STATE_DONTCARE)
查找项目。
参数
item - 开始查找项目索引(查找时不包含当前项目)。
geometry - 查找方向,是一个枚举。值如下:
wx.LIST_NEXT_ABOVE:在指定项目的上方搜索一个项目。这个常量用于在列表组件中向上查找项目。
wx.LIST_NEXT_ALL:按索引顺序搜索后续的项目。这意味着搜索将遍历整个列表组件,从当前项目开始,按照项目的索引顺序(通常是添加顺序)查找下一个项目。
wx.LIST_NEXT_BELOW:在指定项目的下方搜索一个项目。这个常量用于在列表组件中向下查找项目。
wx.LIST_NEXT_LEFT:在指定项目的左侧搜索一个项目。这个常量在列表组件以图标视图或详细列表视图显示时特别有用,因为它允许用户按水平方向查找项目。
wx.LIST_NEXT_RIGHT:在指定项目的右侧搜索一个项目。同样,这个常量在列表组件以图标视图或详细列表视图显示时非常有用,因为它允许用户按水平方向查找项目。
state - 查找状态,是一个枚举值。值如下:
wx.LIST_STATE_DONTCARE:不关心项目的状态。这个常量通常用于在查询或设置项目状态时,表示对某个特定状态不感兴趣或不需要考虑该状态。
wx.LIST_STATE_DROPHILITED:项目表示它是拖放操作的目标。当用户在拖放操作中悬停在某个项目上时,该项目可能会被高亮显示以指示它是潜在的放置位置。
wx.LIST_STATE_FOCUSED:项目具有焦点。在列表控件中,通常只有一个项目可以拥有焦点。
wx.LIST_STATE_SELECTED:项目被选中。选中状态通常用于表示用户已经选择了该项目。
wx.LIST_STATE_CUT:项目被选中作为剪切和粘贴操作的一部分。这个状态通常与复制和粘贴操作结合使用,以指示某个项目已被“剪切”并准备粘贴到另一个位置。
返回
返回第一个找到的项目索引,找不到返回-1。
查找下一个项目
GetNextSelected(self, item)
查找下一个选中的项目。
参数
item - 开始查找项目索引(查找时不包含当前项目)。
返回
返回下一个选中项目的索引,找不到返回-1。
查找选中项目
GetSelectedItemCount(self)
获取选中项目数。
返回
返回选中项目数量。
获取选中项目数
GetTextColour(self)
获取文本颜色对象。
返回
返回文本颜色对象。
获取文本颜色
GetTopItem(self)
获取显示在列表组件框可见区域内最顶端(前面)项的索引。
返回
返回显示在列表组件框可见区域内最顶端(前面)项的索引。
顶端项目索引
GetViewRect(self)
获取列表组件框显示其包含的所有项目所需的最小区域大小,如果列表框组件大小小于该最小区域大小,列表框组件会自动显示滚动条。
返回
返回列表组件框显示其包含的所有项目的最小区域大小。
显示包含所有项目的最小区域大小
HasCheckBoxes(self)
判断列表组件框项目前面是否有复选框。
返回
如果有复选框返回True,否则返回False。
判断列表框组件中的项目前面是否有复选框
HitTest(self, point)
判断指定位置(point)上是否存在项目,返回项目索引和位置的详细信息标志。
参数
point - 指定的位置(x、y坐标组成的元组对象)
返回
返回两个元素的元组,第一个元素为指定位置所在项目的索引(项目不存在返回-1),第二个元素为位置详细信息标志。值如下:
wx.LIST_HITTEST_ABOVE:在项目展示区上。
wx.LIST_HITTEST_BELOW:在项目展示区下。
wx.LIST_HITTEST_TOLEFT:在项目展示区左侧。
wx.LIST_HITTEST_TORIGHT:在项目展示区右侧。
wx.LIST_HITTEST_NOWHERE:在项目展示区内,但不在项目上。
wx.LIST_HITTEST_ONITEMICON:在项目图标上。
wx.LIST_HITTEST_ONITEMLABEL:在项目文本上。
wx.LIST_HITTEST_ONITEMSTATEICON:在状态图标上(如复选框图标等)。
wx.LIST_HITTEST_ONITEM:在项目上(在项目图标(wx.LIST_HITTEST_ONITEMICON)或项目文本(wx.LIST_HITTEST_ONITEMLABEL)或项目状态图标上(wx.LIST_HITTEST_ONITEMSTATEICON)三者之一上)。
获取项目索引和位置的详细信息
InReportView(self)
判断列表组件框是否是报表样式(wx.LC_REPORT)。
返回
如果是报表样式(wx.LC_REPORT)的列表框组件返回True,否则返回False。
判断列表组件框样式
InsertColumn (self, col, heading, format=LIST_FORMAT_LEFT, width=LIST_AUTOSIZE)
插入列(只在报表样式(wx.LC_REPORT)下的列表框组件有效)。
参数
col - 列索引(从0开始)。
heading - 列名称。
format - 列头显示格式(左对齐(wx.LIST_FORMAT_LEFT)、居中(wx.LIST_FORMAT_CENTRE)、右对齐(wx.LIST_FORMAT_RIGHT))
width - 列宽。
报表样式中插入3列