LV_ITEM

【勇芳软件工作室】汉化HomePreviousNext

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_TEXTpszText成员有效或需要填写。
LVIF_IMAGE图像成员有效或需要填写。
LVIF_PARAMlParam的成员有效或需要填写。
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。

也可以看看

LVM_DELETEITEM, LVM_GETITEM, LVM_INSERTITEM, LVM_SETITEM