wxPython中wx.ListCtrl用法(四)
wx.ListCtrl是一个列表组件,可以以列表视图(list view)、报表视图(report view)、图标视图(icon view)和小图标视图(small icon view)等多种模式显示列表。
- 方法
InsertItem (self, index, label, imageIndex)
插入图像或文本项目。
参数
index - 项目插入位置的索引。
label - 插入项目的文本。
imageIndex - 插入项目的图像,为关联列表组件的图像列表(ImageList)里的图像索引。
返回
返回插入项目的索引。
列表组件图标项目
IsEmpty
(self)
判断列表框组件是否为空(包含项目)。
返回
空(不包含项目)返回True,否则返回False。
判断列表框组件是否为空
IsItemChecked
(self, item)
判断项目的选择框是否选中。
参数
item - 项目索引(从0开始)。
返回
项目没有选择框始终返回False,项目有选择框如果选中返回True,没有选中返回False。
判断项目复选框状态
IsSelected
(self, idx)
判断项目是否被选中。
参数
idx - 项目索引(从0开始)。
返回
选中返回True,否则返回False。
判断项目是否选中
IsVisible
(self, item)
判断项目是否在展示区域中可见。
参数
item - 项目索引(从0开始)。
返回
项目在展示区域中返回True,否则返回False。
判断项目是否可见
Select
(self, idx, on=1)
选中或取消选中。
参数
idx - 项目索引(从0开始)。
on - 是否选中,1表示选中,0表示取消选中。
选中索引为2的项目(项目3)
SetBackgroundColour
(self, col)
设置列表组件框背景色。
参数
col - 背景色颜色对象。
返回
设置成功返回True,否则返回False。
设置背景色
SetColumnWidth
(self, col, width)
设置列宽度。
参数
col - 列索引。
width - 列宽度。
返回
设置成功返回True,否则返回False。
设置列宽
SetColumnsOrder
(self, orders)
设置列的排列顺序。
参数
orders - 列顺序数组。
返回
设置成功返回True,否则返回False。
设置列顺序
SetItem (self, index, column, label, imageId=-1)
设置项目。
参数
index - 项目索引(从0开始)。
column - 列索引(从0开始)。
label - 项目文本内容。
imageId - 列表框关联的图像列表中的图像索引。
返回
设置成功返回True,否则返回False。
设置项目
SetItemBackgroundColour
(self, item, col)
设置指定项目的背景色。
参数
item - 项目索引(从0开始)。
col - 背景色颜色对象。
设置项目背景色
SetItemData
(self, item, data)
设置项目的额外数据(设置的额外数据可以用GetItemData函数获取)。
参数
item - 项目索引(从0开始)。
data - 额外数据(整型)。
返回
设置成功返回True,否则返回False。
设置额外数据
SetItemImage
(self, item, image)
设置项目图标。
参数
item - 项目索引(从0开始)。
image - 列表框关联的图像列表中的图像索引。
返回
设置成功返回True,否则返回False。
设置项目图标
SetItemPosition
(self, item, pos)
设置项目的位置(只在图标、小图标样式下有效)。
参数
item - 项目索引(从0开始)。
pos - 位置。
返回
设置成功返回True,否则False。
设置项目位置
SetItemState
(self, item, state, stateMask)
设置项目状态。
参数
item - 项目索引(从0开始)。
state - 状态。
stateMask - 状态掩码。
返回
设置成功返回True,否则返回False。
设置项目状态
SetItemText
(self, item, text)
设置项目文本
参数
item - 项目索引(从0开始)。
text - 项目文本。
设置项目文本内容
SetItemTextColour
(self, item, col)
设置项目文本颜色(只在报表样式下有效)。
参数
item - 项目索引(从0开始)。
col - 颜色对象(wx.Colour)。
设置项目颜色
SetSingleStyle
(self, style, add=True)
设置列表框组件样式。
参数
style - 样式。
add - 是否是添加样式。
设置报表样式
SetTextColour
(self, col)
设置列表框所有项目文本颜色。
参数
col - 颜色对象(wx.Colour)。
设置所有项目文本颜色
SetWindowStyleFlag
(self, style)
清空,并重新设置列表框组件新样式。
参数
style - 样式。
设置为列表样式