首页 > 代码库 > CListCtrl
CListCtrl
CListCtrl
CCmdTarget |
└CListCtrl |
CListCtrl类封装“列表视图控件”功能,显示每个包含图标(列表视图中)和标签的收集。除图标和标签外,每一项还能有显示在图标和标签的右边的列中的信息。
视图
列表视图控件可用四种不同方式显示其内容,称为“视图”。
. | 图标视图 每一项以全尺寸图标(32×32像素)出现,下面有一个标签。用户可在列表视图窗口拖动项到任意位置。 |
· | 小图标 视图每一项以小图标(16×16像素)出现,右边有一个标签。用户可在列表视图窗口拖动项到任意位置。 |
· | 列表视图 每一项以小图标出现,下面有一个标签。项按列排列,不能拖动到列表视图窗口的任何位置。 |
· | 报表视图 每一项在本行上出现,右边有排列成列的附加信息。最左边的列包含小图标和标签,下一列包含应用指定的子项。嵌入标题控件实现这些列。 |
扩展风格
除了标准列表风格,类CListCtrl支持一系列提供丰富功能的扩展风格。此功能的一些示例包括:
· | 逗留选择 有效时,若光标保持在某项上一段时间,则允许自动选择该项。 |
· | 虚列表视图 如果有效,允许控件支持DWORD项。通过把管理应用项数据放在最顶上而成为可能。除了项选择和焦点信息,所有项信息必须由应用管理。 |
· | 单击或双击激活 如果有效,允许热跟踪(项文本自动高亮显示)和高亮显示项的单击和双击激活。 |
· | 拖放列表命令 如果有效,允许拖放列表视图控件中列的记录。只对报表视图有效。 |
项和子项
列表视图控件中的每一项含有一个图标、一个标签、一个当前状态和应用定义值(称为“项数据”)。一个或更多子项还可与每一项联系。一个“子项”是一个字符串,在报表视图中可显示在项图标和标签右边的列里。列表视图控件中的每一项都必须与子项数目相同。
类CListCtrl提供一些函数来插入、删除、查找和更改这些项。
请参阅CListCtrl::GetItem,CListCtrl::InsertItem和CListCtrl::FindItem。
缺省时,列表视图控件负责存储一个项的图标和文本属性。然而,除了这些项类型外,类CListCtrl支持“回调项”。一个“回调项”是一个列表视图项,每个应用棗而不是控件棗存储文本,图标或两者。回调掩码用于指定哪个项的属性(文本和/或图标)由应用提供。
如果应用使用回调项,它必须可以提供按需要提供文本和/或图标属性。回调项在你的应用已有部分这种信息时很有帮助。要了解更多信息,请参阅CListCtrl::GetCallBackMask和“使用CListCtrl:回调项和回调掩码”。
图象列表
图标、标题项图象和应用定义的列表视图项状态包含在一些图象列表中(由类CImageList实现),可创建和指派到列表视图控件中。每个列表视图控件可有四个以上的图象列表类型:
· | 大图标 在图标视图中使用,得到全尺寸图标。 |
· | 小图标 用于小图标、列表和报表视图中,得到图标视图中使用的小版本的图标。 |
· | 应用定义的状态 包含状态图象,在项图标旁显示以指示一个应用定义状态。 |
· | 标题项 用于在报表视图中,得到出现在每个标题控件项中的小图象。 |
缺省时,列表视图控件删除指派给它的图象列表(当它删除时);然而,开发者可通过删除由应用定义的不再使用的图象列表。要了解更多信息,请参阅联机文档“Visual
C++程序员指南”中的“使用CListCtrl:列表项和图象列表”。
#include <afxcmn.h>
请参阅:CImageList
CListCtrl类的成员
构造函数
ClistCtrl | 构造一个CListCtrl对象 |
Create | 创建列表控件并将其附加给CListCtrl对象 |
属性
GetBkColor | 获取列表视图控件的背景色 |
SetBkColor | 设置列表视图控件的背景色 |
GetImageList | 获取用于绘制列表视图项的图象列表的句柄 |
SetImageList | 指定一个图象列表到列表视图控件 |
GetItemCount | 获取列表视图控件中的项的数量 |
GetItem | 获取列表视图项的属性 |
GetCallbackMask | 获取列表视图控件的回调掩码 |
SetCallbackMask | 设置列表视图控件的回调掩码 |
GetNextItem | 查找指定特性和指定指定项关系的列表视图项 |
GetFirstSeletedItemPosition | 在列表视图控件中获取第一个选择的列表视图项的位置 |
GetNextSeletedItem | 为重复而获取下一个选择的列表视图 |
GetItemRect | 获取项的有界矩形 |
SetItemPosition | 在列表视图控件中移动一项到指定位置 |
GetItemPosition | 获取列表视图项的位置 |
GetStringWidth | 指定需要显示所有指定字符串的最小列宽 |
GetEditControl | 获取用于编辑一个项文本的编辑控件的句柄 |
GetColumn | 获取控件的列的属性 |
SetColumn | 设置列表视图列的属性 |
GetColumnWidth | 获取报表视图或列表视图中的列的宽度 |
SetColumnWidth | 改变报表视图或列表视图中的列的宽度 |
GetCheck | 获取与某项相关的状态图象的当前显示状态 |
SetCheck | 设置与某项相关的状态图象的当前显示状态 |
GetViewRect | 获取列表视图控件中所有项的有界矩形 |
GetTextColor | 获取列表视图控件的文本颜色 |
SetTextColor | 设置列表视图控件的文本颜色 |
GetTextBkColor | 获取列表视图控件的文本背景色 |
SetTextBkColor | 设置列表视图控件的文本背景色 |
GetTopIndex | 获取最高级项的索引 |
GetCountPerPage | 计算可正好垂直放入列表视图控件中的项的数目 |
GetOrigin | 获取列表视图控件的最初的当前视图 |
SetItemState | 改变列表视图控件的项的状态 |
GetItemState | 获取列表视图控件的项的状态 |
GetItemText | 获取列表视图项或子项的文本 |
SetItemText | 设置列表视图项或子项的文本 |
SetItemCount | 准备一个列表视图控件以添加大量的项 |
GetItemData | 获取与某项相关的应用所指定的值 |
SetItemData | 设置项的应用指定的值 |
GetSelectedCount | 获取列表视图控件中选择项的数量 |
SetColumnOrderArray | 设置列表视图控件的列序(左或右) |
GetColumnOrderArray | 获取列表视图控件的列序(左或右) |
SetIconSpacing | 设置列表视图控件中的图标的距离 |
GetHeaderCtrl | 获取列表视图控件的标题控件 |
GetHotCursor | 获取在热调试对列表视图控件有效时使用的游标 |
SetHotCursor | 设置在热调试对列表视图控件有效时使用的游标 |
GetSubItemRect | 获取列表视图控件中某项的有界矩形 |
GetHotItem | 获取当前在游标下的列表视图项 |
SetHotItem | 设置列表视图控件的当前热项 |
GetSelectionMark | 获取列表视图控件的选择屏蔽 |
SetSelectionMark | 设置列表视图控件的选择屏蔽 |
GetExtendedStyle | 获取列表视图控件的当前扩展风格 |
SetExtendedStyle | 设置列表视图控件的当前扩展风格 |
SubItemHitTest | 指定哪个列表视图项在指定位置,若存在 |
GetWorkAreas | 获取列表视图控件的当前工作区 |
GetNumberOfWorkAreas | 获取列表视图控件的当前工作区数量 |
SetItemCountEx | 设置虚列表视图控件的项的数量 |
SetWorkAreas | 设置列表视图控件中图标可以显示的区域 |
ApproximateViewRect | 指定显示列表视图控件项所需的宽度和高度 |
GetBkImage | 获取列表视图控件的当前背景图象 |
SetBkImage | 设置列表视图控件的当前背景图象 |
GetHoverTime | 获取列表视图控件的当前逗留时间 |
SetHoverTime | 设置列表视图控件的当前逗留时间 |
操作
InsertItem | 在列表视图控件中插入一个新项 |
DeleteItem | 从控件中删除一项 |
DeleteAllItems | 从控件中删除所有项 |
FindItem | 查找具有指定的字符的列表视图项 |
SortItems | 使用应用定义的比较函数排序列表视图项 |
HitTest | 指定哪个列表视图在指定的位置上 |
EnsureVisible | 保证项是可见的 |
Scroll | 滚动列表视图控件的内容 |
ReDrawItems | 强迫列表视图控件刷新一些项 |
Update | 强迫控件刷新一个指定的项 |
Arrange | 调整一栏里的项 |
EditLabel | 开始项文本该处编辑 |
InsertColumn | 插入列表视图控件中的新列 |
DeleteColumn | 从列表视图控件中删除一列 |
CreateDragImage | 为指定的项构造一个拖动图象列表 |
可覆盖的函数
DrawItem | 当自绘制控件的可视部分改变时被调用 |
CListCtrl