wxPython中wx.ListCtrl用法(三)

发布于:2025-02-11 ⋅ 阅读:(42) ⋅ 点赞:(0)

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列


网站公告

今日签到

点亮在社区的每一天
去签到