LV_ITEM结构指定或接收列表视图项的属性。
typedef struct _LV_ITEM {
UINT mask;
int iItem;
int iSubItem;
UINT state;
UINT stateMask;
LPTSTR pszText;
int cchTextMax;
int iImage; //列表视图项目的图标的索引
LPARAM lParam; //与项目关联的32位值
} LV_ITEM;
会员
面具
一组位标志,用于指定此数据结构的属性或正在使用此结构的操作。
以下位标志指定包含有效数据或需要填写的LV_ITEM结构的成员。可以设置这些位标志中的一个或多个:
值 | 含义 |
LVIF_TEXT | pszText成员有效或需要填写。 |
LVIF_IMAGE | 图像成员有效或需要填写。 |
LVIF_PARAM | lParam的成员有效或需要填写。 |
LVIF_STATE | 州成员有效或需要填写.. |
以下位标志与LVN_GETDISPINFO通知消息一起使用:
值 | 含义 |
LVIF_DI_SETITEM | 操作系统应存储所请求的列表项信息,而不再请求。 |
的iItem
指定此结构引用的项目的从零开始的索引。
iSubItem
指定此结构引用的子项的基于单一索引,如果此结构引用项而不是子项,则为零。
州
指定项目状态正在被检索时的项目的当前状态,如果项目状态被设置,则指定新状态。stateMask成员指定州成员的有效位。该成员可以是状态值的任何有效组合。有关项目状态的列表,请参阅列表查看项目状态.
stateMask
指定州成员的有效位。
pszText
指向如果结构指定项目属性,则包含项目文本的以null结尾的字符串。如果该成员是LPSTR_TEXTCALLBACK值,则该项是回调项。如果列表视图控件具有LVS_SORTASCENDING或LVS_SORTDESCENDING样式,则不要将pszText成员设置为LPSTR_TEXTCALLBACK。
如果结构正在接收项目属性,则该成员是指向接收项目文本的缓冲区的指针。
cchTextMax
如果结构正在接收项目属性,则pszText成员指向的缓冲区的大小。如果结构指定项目属性,则忽略该成员。
图像
列表视图项目的图标在图标和小图标图像列表中的索引。
如果此成员是I_IMAGECALLBACK值,则父窗口负责存储索引。在这种情况下,列表视图控件会向父级发送LVN_GETDISPINFO通知消息,以便在需要显示图像时获取索引。
lParam的
一个与项目关联的32位值。如果使用LVM_SORTITEMS消息,列表视图控件将此值传递给应用程序定义的比较功能。您还可以使用LVM_FINDITEM消息来搜索具有指定lParam的值的项目的列表视图控件。
备注
LV_ITEM结构与许多消息一起使用,包括LVM_GETITEM,LVM_SETITEM,LVM_INSERTITEM和LVM_DELETEITEM。
也可以看看