列表视图

项目
03/12/2025

本部分包含有关与列表视图控件一起使用的编程元素的信息。

综述

主题	内容
关于 List-View 控件的	列表视图控件是显示项集合的窗口。
默认 List-View 消息处理	本部分列出列表视图控件执行的窗口消息处理。
使用 List-View 控件	本部分包含代码示例，演示如何在应用程序中创建和使用列表视图控件。

宏

主题	内容
ListView_ApproximateViewRect	计算显示给定数量的项所需的近似宽度和高度。可以使用此宏或显式发送 LVM_APPROXIMATEVIEWRECT 消息。
ListView_Arrange	排列图标视图中的项目。可以使用此宏或显式发送 LVM_ARRANGE 消息。
ListView_CancelEditLabel	取消项文本编辑作。可以使用此宏或显式发送 LVM_CANCELEDITLABEL 消息。
ListView_CreateDragImage	为指定项创建拖动图像列表。可以使用此宏或显式发送 LVM_CREATEDRAGIMAGE 消息。
ListView_DeleteAllItems	从列表视图控件中删除所有项。可以使用此宏或显式发送 LVM_DELETEALLITEMS 消息。
ListView_DeleteColumn	从列表视图控件中删除列。可以使用此宏或显式发送 LVM_DELETECOLUMN 消息。
ListView_DeleteItem	从列表视图控件中删除项。可以使用此宏或显式发送 LVM_DELETEITEM 消息。
ListView_EditLabel	开始就地编辑指定的列表视图项的文本。该消息隐式选择并聚焦指定项。可以使用此宏或显式发送 LVM_EDITLABEL 消息。
ListView_EnableGroupView	启用或禁用列表视图控件中的项是否显示为组。可以使用此宏或显式发送 LVM_ENABLEGROUPVIEW 消息。
ListView_EnsureVisible	确保列表视图项完全可见或部分可见，如有必要，滚动列表视图控件。可以使用此宏或显式发送 LVM_ENSUREVISIBLE 消息。
ListView_FindItem	搜索具有指定特征的列表视图项。可以使用此宏或显式发送 LVM_FINDITEM 消息。
ListView_GetBkColor	获取列表视图控件的背景色。可以使用此宏或显式发送 LVM_GETBKCOLOR 消息。
ListView_GetBkImage	获取列表视图控件中的背景图像。可以使用此宏或显式发送 LVM_GETBKIMAGE 消息。
ListView_GetCallbackMask	获取列表视图控件的回调掩码。可以使用此宏或显式发送 LVM_GETCALLBACKMASK 消息。
ListView_GetCheckState	确定是否选择了列表视图控件中的项。这只应用于具有 LVS_EX_CHECKBOXES 样式的列表视图控件。
ListView_GetColumn	获取列表视图控件的列的属性。可以使用此宏或显式发送 LVM_GETCOLUMN 消息。
ListView_GetColumnOrderArray	获取列表视图控件中列的当前从左到右的顺序。可以使用此宏或显式发送 LVM_GETCOLUMNORDERARRAY 消息。
ListView_GetColumnWidth	获取报表或列表视图中列的宽度。可以使用此宏或显式发送 LVM_GETCOLUMNWIDTH 消息。
ListView_GetCountPerPage	计算在列表视图或报表视图中时，可在列表视图控件的可见区域中垂直容纳的项数。仅对完全可见的项进行计数。可以使用此宏或显式发送 LVM_GETCOUNTPERPAGE 消息。
ListView_GetEditControl	获取用于编辑列表视图项文本的编辑控件的句柄。可以使用此宏或显式发送 LVM_GETEDITCONTROL 消息。
ListView_GetEmptyText	获取列表视图控件显示为空时要显示的文本。使用此宏或显式发送 LVM_GETEMPTYTEXT 消息。
ListView_GetExtendedListViewStyle	获取当前用于给定列表视图控件的扩展样式。可以使用此宏或显式发送 LVM_GETEXTENDEDLISTVIEWSTYLE 消息。
ListView_GetFocusedGroup	获取具有焦点的组。使用此宏或显式发送 LVM_GETFOCUSEDGROUP 消息。
ListView_GetFooterInfo	获取有关指定列表视图控件的页脚的信息。使用此宏或显式发送 LVM_GETFOOTERINFO 消息。
ListView_GetFooterItem	获取有关指定列表视图控件的页脚项的信息。使用此宏或显式发送 LVM_GETFOOTERITEM 消息。
ListView_GetFooterItemRect	获取列表视图控件中指定项的页脚坐标。使用此宏或显式发送 LVM_GETFOOTERITEMRECT 消息。
ListView_GetFooterRect	获取指定列表视图控件的页脚坐标。使用此宏或显式发送 LVM_GETFOOTERRECT 消息。
ListView_GetGroupCount	获取组数。可以使用此宏或显式发送 LVM_GETGROUPCOUNT 消息。
ListView_GetGroupHeaderImageList	获取已为现有列表视图控件设置的组标头图像列表。
ListView_GetGroupInfo	获取组信息。可以使用此宏或显式发送 LVM_GETGROUPINFO 消息。
ListView_GetGroupInfoByIndex	获取有关指定组的信息。使用此宏或显式发送 LVM_GETGROUPINFOBYINDEX 消息。
ListView_GetGroupMetrics	获取有关组显示的信息。可以使用此宏或显式发送 LVM_GETGROUPMETRICS 消息。
ListView_GetGroupRect	获取指定组的矩形。使用此宏或显式发送 LVM_GETGROUPRECT 消息。
ListView_GetGroupState	获取指定组的状态。使用此宏或显式发送 LVM_GETGROUPSTATE 消息。
ListView_GetHeader	获取列表视图控件使用的标头控件的句柄。可以使用此宏或显式发送 LVM_GETHEADER 消息。
ListView_GetHotCursor	获取启用热跟踪时指针在项上时使用的 HCURSOR。可以使用此宏或显式发送 LVM_GETHOTCURSOR 消息。
ListView_GetHotItem	获取热项的索引。可以使用此宏或显式发送 LVM_GETHOTITEM 消息。
ListView_GetHoverTime	获取鼠标光标在选定项之前必须悬停在项上的时间量。可以使用此宏或显式发送 LVM_GETHOVERTIME 消息。
ListView_GetImageList	获取用于绘制列表视图项的图像列表的句柄。可以使用此宏或显式发送 LVM_GETIMAGELIST 消息。
ListView_GetInsertMark	获取插入点的位置。可以使用此宏或显式发送 LVM_GETINSERTMARK 消息。
ListView_GetInsertMarkColor	获取插入点的颜色。可以使用此宏或显式发送 LVM_GETINSERTMARKCOLOR 消息。
ListView_GetInsertMarkRect	获取绑定插入点的矩形。可以使用此宏或显式发送 LVM_GETINSERTMARKRECT 消息。
ListView_GetISearchString	获取列表视图控件的增量搜索字符串。可以使用此宏或显式发送 LVM_GETISEARCHSTRING 消息。
ListView_GetItem	获取列表视图项的一些或全部属性。可以使用此宏或显式发送 LVM_GETITEM 消息。
ListView_GetItemCount	获取列表视图控件中的项数。可以使用此宏或显式发送 LVM_GETITEMCOUNT 消息。
ListView_GetItemIndexRect	获取指定列表视图控件当前视图中子项的所有或部分的边界矩形。使用此宏或显式发送 LVM_GETITEMINDEXRECT 消息。
ListView_GetItemPosition	获取列表视图项的位置。可以使用此宏或显式发送 LVM_GETITEMPOSITION 消息。
ListView_GetItemRect	获取当前视图中项的所有或部分的边界矩形。可以使用此宏或显式发送 LVM_GETITEMRECT 消息。
ListView_GetItemSpacing	确定列表视图控件中项之间的间距。可以使用此宏或显式发送 LVM_GETITEMSPACING 消息。
ListView_GetItemState	获取列表视图项的状态。可以使用此宏或显式发送 LVM_GETITEMSTATE 消息。
ListView_GetItemText	获取列表视图项或子项的文本。可以使用此宏或显式发送 LVM_GETITEMTEXT 消息。
ListView_GetNextItem	搜索具有指定属性的列表视图项，并将指定的关系承载到指定项。可以使用此宏或显式发送 LVM_GETNEXTITEM 消息。
ListView_GetNextItemIndex	获取特定列表视图控件中具有指定属性和与其他特定项关系的项的索引。使用此宏或显式发送 LVM_GETNEXTITEMINDEX 消息。
ListView_GetNumberOfWorkAreas	获取列表视图控件中工作区域的数目。可以使用此宏或显式发送 LVM_GETNUMBEROFWORKAREAS 消息。
ListView_GetOrigin	获取列表视图控件的当前视图原点。可以使用此宏或显式发送 LVM_GETORIGIN 消息。
ListView_GetOutlineColor	如果设置了 LVS_EX_BORDERSELECT 扩展窗口样式，则获取列表视图控件边框的颜色。可以使用此宏或显式发送 LVM_GETOUTLINECOLOR 消息。
ListView_GetSelectedColumn	获取一个指定所选列的整数。可以使用此宏或显式发送 LVM_GETSELECTEDCOLUMN 消息。
ListView_GetSelectedCount	确定列表视图控件中选定项的数目。可以使用此宏或显式发送 LVM_GETSELECTEDCOUNT 消息。
ListView_GetSelectionMark	从列表视图控件获取选择标记。可以使用此宏或显式发送 LVM_GETSELECTIONMARK 消息。
ListView_GetStringWidth	使用指定的列表视图控件的当前字体确定指定字符串的宽度。可以使用此宏或显式发送 LVM_GETSTRINGWIDTH 消息。
ListView_GetSubItemRect	获取有关列表视图控件中子项周围的矩形的信息。可以使用此宏（建议）或显式发送 LVM_GETSUBITEMRECT 消息。此宏仅用于使用 LVS_REPORT 样式的列表视图控件。
ListView_GetTextBkColor	获取列表视图控件的文本背景色。可以使用此宏或显式发送 LVM_GETTEXTBKCOLOR 消息。
ListView_GetTextColor	获取列表视图控件的文本颜色。可以使用此宏或显式发送 LVM_GETTEXTCOLOR 消息。
ListView_GetTileInfo	获取有关列表视图控件中的磁贴的信息。可以使用此宏或显式发送 LVM_GETTILEINFO 消息。
ListView_GetTileViewInfo	获取有关磁贴视图中列表视图控件的信息。可以使用此宏或显式发送 LVM_GETTILEVIEWINFO 消息。
ListView_GetToolTips	获取列表视图控件用于显示工具提示的工具提示控件。可以使用此宏或显式发送 LVM_GETTOOLTIPS 消息。
ListView_GetTopIndex	获取列表或报表视图中最顶部可见项的索引。可以使用此宏或显式发送 LVM_GETTOPINDEX 消息。
ListView_GetUnicodeFormat	获取控件的 Unicode 字符格式标志。可以使用此宏或显式发送 LVM_GETUNICODEFORMAT 消息。
ListView_GetView	获取列表视图控件的当前视图。可以使用此宏或显式发送 LVM_GETVIEW 消息。
ListView_GetViewRect	获取列表视图控件中所有项的边界矩形。列表视图必须位于图标或小型图标视图中。可以使用此宏或显式发送 LVM_GETVIEWRECT 消息。
ListView_GetWorkAreas	从列表视图控件获取工作区域。可以使用此宏，或显式发送 LVM_GETWORKAREAS 消息。
ListView_HasGroup	确定列表视图控件是否具有指定的组。可以使用此宏或显式发送 LVM_HASGROUP 消息。
ListView_HitTest	确定位于指定位置的列表视图项（如果有）。可以使用此宏或显式发送 LVM_HITTEST 消息。
ListView_HitTestEx	确定位于指定位置的列表视图项（如果有）。可以使用此宏或显式发送 LVM_HITTEST 消息。
ListView_InsertColumn	在列表视图控件中插入新列。可以使用此宏或显式发送 LVM_INSERTCOLUMN 消息。
ListView_InsertGroup	将组插入列表视图控件。可以使用此宏或显式发送 LVM_INSERTGROUP 消息。
ListView_InsertGroupSorted	将组插入到有序的组列表中。可以使用此宏或显式发送 LVM_INSERTGROUPSORTED 消息。
ListView_InsertItem	在列表视图控件中插入新项。可以使用此宏或显式发送 LVM_INSERTITEM 消息。
ListView_InsertMarkHitTest	检索离指定点最近的插入点。可以使用此宏或显式发送 LVM_INSERTMARKHITTEST 消息。
ListView_IsGroupViewEnabled	检查列表视图控件是否已启用组视图。可以使用此宏或显式发送 LVM_ISGROUPVIEWENABLED 消息。
ListView_IsItemVisible	指示列表视图控件中的项是否可见。使用此宏或显式发送 LVM_ISITEMVISIBLE 消息。
ListView_MapIDToIndex	将项的 ID 映射到索引。可以使用此宏或显式发送 LVM_MAPIDTOINDEX 消息。
ListView_MapIndexToID	将项的索引映射到唯一 ID。可以使用此宏或显式发送 LVM_MAPINDEXTOID 消息。
ListView_MoveGroup	未实现。
ListView_MoveItemToGroup	未实现。
ListView_RedrawItems	强制列表视图控件重新绘制一系列项。可以使用此宏或显式发送 LVM_REDRAWITEMS 消息。
ListView_RemoveAllGroups	从列表视图控件中删除所有组。可以使用此宏或显式发送 LVM_REMOVEALLGROUPS 消息。
ListView_RemoveGroup	从列表视图控件中删除组。可以使用此宏或显式发送 LVM_REMOVEGROUP 消息。
ListView_Scroll	滚动列表视图控件的内容。可以使用此宏或显式发送 LVM_SCROLL 消息。
ListView_SetBkColor	设置列表视图控件的背景色。可以使用此宏或显式发送 LVM_SETBKCOLOR 消息。
ListView_SetBkImage	设置列表视图控件中的背景图像。可以使用此宏或显式发送 LVM_SETBKIMAGE 消息。
ListView_SetCallbackMask	更改列表视图控件的回调掩码。可以使用此宏或显式发送 LVM_SETCALLBACKMASK 消息。
ListView_SetCheckState	选择或取消选择列表视图控件中的项。可以使用此宏或显式发送 LVM_SETITEMSTATE 消息。
ListView_SetColumn	设置列表视图列的属性。可以使用此宏或显式发送 LVM_SETCOLUMN 消息。
ListView_SetColumnOrderArray	设置列表视图控件中列的从左到右的顺序。可以使用此宏或显式发送 LVM_SETCOLUMNORDERARRAY 消息。
ListView_SetColumnWidth	用于更改报表视图中列的宽度或列表视图模式下所有列的宽度。可以使用此宏或显式发送 LVM_SETCOLUMNWIDTH 消息。
ListView_SetExtendedListViewStyle	设置列表视图控件的扩展样式。可以使用此宏或显式发送 LVM_SETEXTENDEDLISTVIEWSTYLE 消息。
ListView_SetExtendedListViewStyleEx	使用样式掩码设置列表视图控件的扩展样式。可以使用此宏或显式发送 LVM_SETEXTENDEDLISTVIEWSTYLE 消息。
ListView_SetGroupHeaderImageList	将图像列表分配给列表视图控件的组标头。
ListView_SetGroupInfo	设置组信息。可以使用此宏或显式发送 LVM_SETGROUPINFO 消息。
ListView_SetGroupMetrics	设置有关组显示的信息。可以使用此宏或显式发送 LVM_SETGROUPMETRICS 消息。
ListView_SetGroupState	设置指定组的状态。
ListView_SetHotCursor	设置列表视图控件在启用热跟踪时在项上时使用的 HCURSOR。可以使用此宏或显式发送 LVM_SETHOTCURSOR 消息。若要检查是否启用了热跟踪，请调用 SystemParametersInfo。
ListView_SetHotItem	设置列表视图控件中的热项。可以使用此宏或显式发送 LVM_SETHOTITEM 消息。
ListView_SetHoverTime	设置鼠标光标在选定项之前必须悬停在项上的时间量。可以使用此宏或显式发送 LVM_SETHOVERTIME 消息。
ListView_SetIconSpacing	设置列表视图控件中图标之间的间距设置为 LVS_ICON 样式。可以使用此宏或显式发送 LVM_SETICONSPACING 消息。
ListView_SetImageList	将图像列表分配给列表视图控件。可以使用此宏或显式发送 LVM_SETIMAGELIST 消息。
ListView_SetInfoTip	设置工具提示文本。可以使用此宏或显式发送 LVM_SETINFOTIP 消息。
ListView_SetInsertMark	将插入点设置为定义的位置。可以使用此宏或显式发送 LVM_SETINSERTMARK 消息。
ListView_SetInsertMarkColor	设置插入点的颜色。可以使用此宏或显式发送 LVM_SETINSERTMARKCOLOR 消息。
ListView_SetItem	设置列表视图项的部分或全部属性。还可以使用 ListView_SetItem 设置子项的文本。可以使用此宏或显式发送 LVM_SETITEM 消息。
ListView_SetItemCount	使列表视图控件为指定的项数分配内存。可以使用此宏或显式发送 LVM_SETITEMCOUNT 消息。
ListView_SetItemCountEx	设置虚拟列表视图中的虚拟项数。可以使用此宏或显式发送 LVM_SETITEMCOUNT 消息。
ListView_SetItemIndexState	设置指定列表视图项的状态。使用此宏或显式发送 LVM_SETITEMINDEXSTATE 消息。
ListView_SetItemPosition	将项移动到列表视图控件中的指定位置（在图标或小图标视图中）。可以使用此宏或显式发送 LVM_SETITEMPOSITION 消息。
ListView_SetItemPosition32	将项移动到列表视图控件中的指定位置（在图标或小图标视图中）。此宏不同于 ListView_SetItemPosition 宏，因为它使用 32 位坐标。可以使用 ListView_SetItemPosition32 宏或显式发送 LVM_SETITEMPOSITION32 消息。
ListView_SetItemState	更改列表视图控件中项的状态。可以使用此宏或显式发送 LVM_SETITEMSTATE 消息。
ListView_SetItemText	更改列表视图项或子项的文本。可以使用此宏或显式发送 LVM_SETITEMTEXT 消息。
ListView_SetOutlineColor	如果设置了 LVS_EX_BORDERSELECT 扩展窗口样式，则设置列表视图控件边框的颜色。可以使用此宏或显式发送 LVM_SETOUTLINECOLOR 消息。
ListView_SetSelectedColumn	设置所选列的索引。可以使用此宏或显式发送 LVM_SETSELECTEDCOLUMN 消息。
ListView_SetSelectionMark	设置列表视图控件中的选择标记。可以使用此宏或显式发送 LVM_SETSELECTIONMARK 消息。
ListView_SetTextBkColor	设置列表视图控件中文本的背景色。可以使用此宏或显式发送 LVM_SETTEXTBKCOLOR 消息。
ListView_SetTextColor	设置列表视图控件的文本颜色。可以使用此宏或显式发送 LVM_SETTEXTCOLOR 消息。
ListView_SetTileInfo	设置列表视图控件的现有磁贴的信息。可以使用此宏或显式发送 LVM_SETTILEINFO 消息。
ListView_SetTileViewInfo	设置列表视图控件在磁贴视图中使用的信息。可以使用此宏或显式发送 LVM_SETTILEVIEWINFO 消息。
ListView_SetToolTips	设置列表视图控件用于显示工具提示的工具提示控件。可以使用此宏或显式发送 LVM_SETTOOLTIPS 消息。
ListView_SetUnicodeFormat	设置控件的 Unicode 字符格式标志。此消息允许你在运行时更改控件使用的字符集，而无需重新创建控件。可以使用此宏或显式发送 LVM_SETUNICODEFORMAT 消息。
ListView_SetView	设置列表视图控件的视图。可以使用此宏或显式发送 LVM_SETVIEW 消息。
ListView_SetWorkAreas	设置列表视图控件中的工作区域。可以使用此宏或显式发送 LVM_SETWORKAREAS 消息。
ListView_SortGroups	使用应用程序定义的比较函数按列表视图控件中的 ID 对组进行排序。可以使用此宏或显式发送 LVM_SORTGROUPS 消息。
ListView_SortItems	使用应用程序定义的比较函数对列表视图控件的项进行排序。每个项的索引会更改以反映新序列。可以使用此宏或显式发送 LVM_SORTITEMS 消息。
ListView_SortItemsEx	使用应用程序定义的比较函数对列表视图控件的项进行排序。每个项的索引会更改以反映新序列。可以使用此宏或显式发送 LVM_SORTITEMSEX 消息。
ListView_SubItemHitTest	确定位于给定位置的列表视图项或子项。可以使用此宏或显式发送 LVM_SUBITEMHITTEST 消息。
ListView_SubItemHitTestEx	确定位于给定位置的列表视图项或子项。可以使用此宏或显式发送 LVM_SUBITEMHITTEST 消息。
ListView_Update	更新列表视图项。如果列表视图控件具有 LVS_AUTOARRANGE 样式，则此宏会导致排列列表视图控件。可以使用此宏或显式发送 LVM_UPDATE 消息。

消息

主题	内容
LVM_APPROXIMATEVIEWRECT	计算显示给定数量的项所需的近似宽度和高度。可以显式发送此消息或使用 ListView_ApproximateViewRect 宏。
LVM_ARRANGE	排列图标视图中的项目。可以显式发送此消息，也可以使用 ListView_Arrange 宏发送。
LVM_CANCELEDITLABEL	取消项文本编辑作。
LVM_CREATEDRAGIMAGE	为指定项创建拖动图像列表。可以显式发送此消息，也可以使用 ListView_CreateDragImage 宏发送。
LVM_DELETEALLITEMS	从列表视图控件中删除所有项。可以显式发送此消息，也可以使用 ListView_DeleteAllItems 宏发送。
LVM_DELETECOLUMN	从列表视图控件中删除列。可以显式发送此消息，也可以使用 ListView_DeleteColumn 宏发送。
LVM_DELETEITEM	从列表视图控件中删除项。可以显式发送此消息，也可以使用 ListView_DeleteItem 宏发送。
LVM_EDITLABEL	开始就地编辑指定的列表视图项的文本。该消息隐式选择并聚焦指定项。可以显式发送此消息，也可以使用 ListView_EditLabel 宏发送。
LVM_ENABLEGROUPVIEW	启用或禁用列表视图控件中的项是否显示为组。
LVM_ENSUREVISIBLE	确保列表视图项完全可见或部分可见，如有必要，滚动列表视图控件。可以显式发送此消息，也可以使用 ListView_EnsureVisible 宏发送。
LVM_FINDITEM	搜索具有指定特征的列表视图项。可以显式发送此消息，也可以使用 ListView_FindItem 宏发送。
LVM_GETBKCOLOR	获取列表视图控件的背景色。可以显式发送此消息，也可以使用 ListView_GetBkColor 宏发送。
LVM_GETBKIMAGE	获取列表视图控件中的背景图像。可以显式发送此消息，也可以使用 ListView_GetBkImage 宏发送。
LVM_GETCALLBACKMASK	获取列表视图控件的回调掩码。可以显式发送此消息，也可以使用 ListView_GetCallbackMask 宏发送。
LVM_GETCOLUMN	获取列表视图控件的列的属性。可以显式发送此消息，也可以使用 ListView_GetColumn 宏发送。
LVM_GETCOLUMNORDERARRAY	获取列表视图控件中列的当前从左到右的顺序。可以显式发送此消息或使用 ListView_GetColumnOrderArray 宏。
LVM_GETCOLUMNWIDTH	获取报表或列表视图中列的宽度。可以显式发送此消息，也可以使用 ListView_GetColumnWidth 宏发送。
LVM_GETCOUNTPERPAGE	计算在列表视图或报表视图中时，可在列表视图控件的可见区域中垂直容纳的项数。仅对完全可见的项进行计数。可以显式发送此消息，也可以使用 ListView_GetCountPerPage 宏发送。
LVM_GETEDITCONTROL	获取用于编辑列表视图项文本的编辑控件的句柄。可以显式发送此消息，也可以使用 ListView_GetEditControl 宏发送。
LVM_GETEMPTYTEXT	获取列表视图控件显示为空时要显示的文本。显式发送此消息或使用 ListView_GetEmptyText 宏发送。
LVM_GETEXTENDEDLISTVIEWSTYLE	获取当前用于给定列表视图控件的扩展样式。可以显式发送此消息或使用 ListView_GetExtendedListViewStyle 宏。
LVM_GETFOCUSEDGROUP	获取具有焦点的组。显式发送此消息或使用 ListView_GetFocusedGroup 宏发送。
LVM_GETFOOTERINFO	获取有关列表视图控件的页脚的信息。显式发送此消息或使用 ListView_GetFooterInfo 宏发送。
LVM_GETFOOTERITEM	获取列表视图控件中页脚项的相关信息。显式发送此消息或使用 ListView_GetFooterItem 宏发送。
LVM_GETFOOTERITEMRECT	获取列表视图控件中指定项的页脚坐标。显式发送此消息或使用 ListView_GetFooterItemRect 宏发送。
LVM_GETFOOTERRECT	检索列表视图控件的页脚坐标。显式发送此消息或使用 ListView_GetFooterRect 宏发送。
LVM_GETGROUPCOUNT	获取组数。
LVM_GETGROUPINFO	获取组信息。
LVM_GETGROUPINFOBYINDEX	获取有关指定组的信息。显式发送此消息或使用 ListView_GetGroupInfoByIndex 宏发送。
LVM_GETGROUPMETRICS	获取有关组显示的信息。
LVM_GETGROUPRECT	获取指定组的矩形。显式发送此消息或使用 ListView_GetGroupRect 宏发送。
LVM_GETGROUPSTATE	获取指定组的状态。显式发送此消息或使用 ListView_GetGroupState 宏发送。
LVM_GETHEADER	获取列表视图控件使用的标头控件的句柄。可以显式发送此消息或使用 ListView_GetHeader 宏。
LVM_GETHOTCURSOR	检索启用热跟踪时指针位于项目上方时使用的 HCURSOR 值。可以显式发送此消息或使用 ListView_GetHotCursor 宏。
LVM_GETHOTITEM	检索热项的索引。可以显式发送此消息或使用 ListView_GetHotItem 宏。
LVM_GETHOVERTIME	检索鼠标光标在选定项之前必须悬停在项上的时间量。可以显式发送此消息或使用 ListView_GetHoverTime 宏。
LVM_GETIMAGELIST	检索用于绘制列表视图项的图像列表的句柄。可以显式发送此消息，也可以使用 ListView_GetImageList 宏发送。
LVM_GETINSERTMARK	检索插入点的位置。
LVM_GETINSERTMARKCOLOR	检索插入点的颜色。
LVM_GETINSERTMARKRECT	检索绑定插入点的矩形。
LVM_GETISEARCHSTRING	检索列表视图控件的增量搜索字符串。可以显式发送此消息，也可以使用 ListView_GetISearchString 宏发送。
LVM_GETITEM	检索列表视图项的某些或全部属性。可以显式发送此消息，也可以使用 ListView_GetItem 宏发送。
LVM_GETITEMCOUNT	检索列表视图控件中的项数。可以显式发送此消息，也可以使用 ListView_GetItemCount 宏发送。
LVM_GETITEMINDEXRECT	检索列表视图控件当前视图中子项的所有或部分的边界矩形。显式发送此消息或使用 ListView_GetItemIndexRect 宏发送。
LVM_GETITEMPOSITION	检索列表视图项的位置。可以显式发送此消息，也可以使用 ListView_GetItemPosition 宏发送。
LVM_GETITEMRECT	检索当前视图中项的所有或部分的边界矩形。可以显式发送此消息，也可以使用 ListView_GetItemRect 宏发送。
LVM_GETITEMSPACING	确定列表视图控件中项之间的间距。可以显式发送此消息，也可以使用 ListView_GetItemSpacing 宏发送。
LVM_GETITEMSTATE	检索列表视图项的状态。可以显式发送此消息，也可以使用 ListView_GetItemState 宏发送。
LVM_GETITEMTEXT	检索列表视图项或子项的文本。可以显式发送此消息，也可以使用 ListView_GetItemText 宏发送。
LVM_GETNEXTITEM	搜索具有指定属性的列表视图项，并将指定的关系承载到指定项。可以显式发送此消息，也可以使用 ListView_GetNextItem 宏发送。
LVM_GETNEXTITEMINDEX	检索与指定属性和与其他项的关系匹配的指定列表视图控件中的项的索引。显式发送此消息或使用 ListView_GetNextItemIndex 宏发送。
LVM_GETNUMBEROFWORKAREAS	检索列表视图控件中工作区域的数目。可以显式发送此消息或使用 ListView_GetNumberOfWorkAreas 宏。
LVM_GETORIGIN	检索列表视图控件的当前视图原点。可以显式发送此消息，也可以使用 ListView_GetOrigin 宏发送。
LVM_GETOUTLINECOLOR	如果设置了 LVS_EX_BORDERSELECT 扩展窗口样式，则检索列表视图控件边框的颜色。
LVM_GETSELECTEDCOLUMN	检索指定所选列的整数。
LVM_GETSELECTEDCOUNT	确定列表视图控件中选定项的数目。可以显式发送此消息，也可以使用 ListView_GetSelectedCount 宏发送。
LVM_GETSELECTIONMARK	从列表视图控件中检索选择标记。可以显式发送此消息或使用 ListView_GetSelectionMark 宏。
LVM_GETSTRINGWIDTH	使用指定的列表视图控件的当前字体确定指定字符串的宽度。可以显式发送此消息，也可以使用 ListView_GetStringWidth 宏发送。
LVM_GETSUBITEMRECT	检索有关列表视图控件中子项的边界矩形的信息。可以显式发送此消息，也可以使用 ListView_GetSubItemRect 宏（建议）。此消息仅用于使用 LVS_REPORT 样式的列表视图控件。
LVM_GETTEXTBKCOLOR	检索列表视图控件的文本背景色。可以显式发送此消息，也可以使用 ListView_GetTextBkColor 宏发送。
LVM_GETTEXTCOLOR	检索列表视图控件的文本颜色。可以显式发送此消息，也可以使用 ListView_GetTextColor 宏发送。
LVM_GETTILEINFO	检索有关列表视图控件中磁贴的信息。
LVM_GETTILEVIEWINFO	检索磁贴视图中列表视图控件的相关信息。
LVM_GETTOOLTIPS	检索列表视图控件用于显示工具提示的工具提示控件。可以显式发送此消息或使用 ListView_GetToolTips 宏。
LVM_GETTOPINDEX	在列表或报表视图中检索最顶部可见项的索引。可以显式发送此消息，也可以使用 ListView_GetTopIndex 宏发送。
LVM_GETUNICODEFORMAT	检索控件的 UNICODE 字符格式标志。可以显式发送此消息或使用 ListView_GetUnicodeFormat 宏。
LVM_GETVIEW	检索列表视图控件的当前视图。
LVM_GETVIEWRECT	检索列表视图控件中所有项的边界矩形。列表视图必须位于图标或小型图标视图中。可以显式发送此消息，也可以使用 ListView_GetViewRect 宏发送。
LVM_GETWORKAREAS	从列表视图控件中检索工作区域。可以显式发送此消息或使用 ListView_GetWorkAreas 宏。
LVM_HASGROUP	确定列表视图控件是否具有指定的组。
LVM_HITTEST	确定位于指定位置的列表视图项（如果有）。可以显式发送此消息，也可以使用 ListView_HitTest 宏发送。
LVM_INSERTCOLUMN	在列表视图控件中插入新列。可以显式发送此消息，也可以使用 ListView_InsertColumn 宏发送。
LVM_INSERTGROUP	将组插入列表视图控件。
LVM_INSERTGROUPSORTED	将组插入到有序的组列表中。
LVM_INSERTITEM	在列表视图控件中插入新项。可以显式发送此消息，也可以使用 ListView_InsertItem 宏发送。
LVM_INSERTMARKHITTEST	检索离指定点最近的插入点。
LVM_ISGROUPVIEWENABLED	检查列表视图控件是否已启用组视图。
LVM_ISITEMVISIBLE	指示列表视图控件中的项是否可见。显式发送此消息或使用 ListView_IsItemVisible 宏发送。
LVM_MAPIDTOINDEX	将项的 ID 映射到索引。
LVM_MAPINDEXTOID	将项的索引映射到唯一 ID。
LVM_MOVEGROUP	未实现。
LVM_MOVEITEMTOGROUP	未实现。
LVM_REDRAWITEMS	强制列表视图控件重新绘制一系列项。可以显式发送此消息，也可以使用 ListView_RedrawItems 宏发送。
LVM_REMOVEALLGROUPS	从列表视图控件中删除所有组。
LVM_REMOVEGROUP	从列表视图控件中删除组。
LVM_SCROLL	滚动列表视图控件的内容。可以显式发送此消息，也可以使用 ListView_Scroll 宏发送。
LVM_SETBKCOLOR	设置列表视图控件的背景色。可以显式发送此消息，也可以使用 ListView_SetBkColor 宏发送。
LVM_SETBKIMAGE	设置列表视图控件中的背景图像。可以显式发送此消息，也可以使用 ListView_SetBkImage 宏发送。
LVM_SETCALLBACKMASK	更改列表视图控件的回调掩码。可以显式发送此消息，也可以使用 ListView_SetCallbackMask 宏发送。
LVM_SETCOLUMN	设置列表视图列的属性。可以显式发送此消息，也可以使用 ListView_SetColumn 宏发送。
LVM_SETCOLUMNORDERARRAY	设置列表视图控件中列的从左到右的顺序。可以显式发送此消息或使用 ListView_SetColumnOrderArray 宏。
LVM_SETCOLUMNWIDTH	在报表视图模式下更改列的宽度或列表视图模式下所有列的宽度。可以显式发送此消息或使用 ListView_SetColumnWidth 宏。
LVM_SETEXTENDEDLISTVIEWSTYLE	设置列表视图控件中的扩展样式。可以显式发送此消息或使用 ListView_SetExtendedListViewStyle 或 ListView_SetExtendedListViewStyleEx 宏。
LVM_SETGROUPINFO	设置组信息。
LVM_SETGROUPMETRICS	设置有关组显示的信息。
LVM_SETHOTCURSOR	设置列表视图控件在启用热跟踪时在项上时使用的 HCURSOR 值。可以显式发送此消息或使用 ListView_SetHotCursor 宏。若要检查是否启用了热跟踪，请调用 SystemParametersInfo。
LVM_SETHOTITEM	设置列表视图控件的热项。可以显式发送此消息或使用 ListView_SetHotItem 宏。
LVM_SETHOVERTIME	设置鼠标光标在选定项之前必须悬停在项上的时间量。可以显式发送此消息或使用 ListView_SetHoverTime 宏。
LVM_SETICONSPACING	设置列表视图控件中具有 LVS_ICON 样式的图标之间的间距。可以显式发送此消息，也可以使用 ListView_SetIconSpacing 宏发送。
LVM_SETIMAGELIST	将图像列表分配给列表视图控件。可以显式发送此消息，也可以使用 ListView_SetImageList 宏发送。
LVM_SETINFOTIP	设置工具提示文本。
LVM_SETINSERTMARK	将插入点设置为定义的位置。
LVM_SETINSERTMARKCOLOR	设置插入点的颜色。
LVM_SETITEM	设置列表视图项的部分或全部属性。还可以发送LVM_SETITEM来设置子项的文本。可以显式发送此消息，也可以使用 ListView_SetItem 宏发送。
LVM_SETITEMCOUNT	使列表视图控件为指定的项数分配内存，或设置虚拟列表视图控件中的虚拟项数。这取决于列表视图控件的创建方式。可以显式发送此消息或使用 ListView_SetItemCount 或 ListView_SetItemCountEx 宏。
LVM_SETITEMINDEXSTATE	设置列表视图项的状态。显式发送此消息或使用 ListView_SetItemIndexState 宏发送。
LVM_SETITEMPOSITION	将项移动到列表视图控件中的指定位置（必须位于图标或小图标视图中）。可以显式发送此消息，也可以使用 ListView_SetItemPosition 宏发送。
LVM_SETITEMPOSITION32	将项移动到列表视图控件中的指定位置（必须位于图标或小图标视图中）。此消息不同于 LVM_SETITEMPOSITION 消息，因为它使用 32 位坐标。可以显式发送此消息，也可以使用 ListView_SetItemPosition32 宏发送。
LVM_SETITEMSTATE	更改列表视图控件中项的状态。可以显式发送此消息，也可以使用 ListView_SetItemState 宏发送。
LVM_SETITEMTEXT	更改列表视图项或子项的文本。可以显式发送此消息，也可以使用 ListView_SetItemText 宏发送。
LVM_SETOUTLINECOLOR	如果设置了 LVS_EX_BORDERSELECT 扩展窗口样式，则设置列表视图控件边框的颜色。
LVM_SETSELECTEDCOLUMN	设置所选列的索引。
LVM_SETSELECTIONMARK	设置列表视图控件中的选择标记。可以显式发送此消息或使用 ListView_SetSelectionMark 宏。
LVM_SETTEXTBKCOLOR	设置列表视图控件中文本的背景色。可以显式发送此消息，也可以使用 ListView_SetTextBkColor 宏发送。
LVM_SETTEXTCOLOR	设置列表视图控件的文本颜色。可以显式发送此消息，也可以使用 ListView_SetTextColor 宏发送。
LVM_SETTILEINFO	设置列表视图控件的现有磁贴的信息。
LVM_SETTILEVIEWINFO	设置列表视图控件在磁贴视图中使用的信息。
LVM_SETTILEWIDTH	目前不支持。
LVM_SETTOOLTIPS	设置列表视图控件用于显示工具提示的工具提示控件。可以显式发送此消息或使用 ListView_SetToolTips 宏。
LVM_SETUNICODEFORMAT	设置控件的 UNICODE 字符格式标志。此消息允许你在运行时更改控件使用的字符集，而无需重新创建控件。可以显式发送此消息或使用 ListView_SetUnicodeFormat 宏。
LVM_SETVIEW	设置列表视图控件的视图。
LVM_SETWORKAREAS	设置列表视图控件中的工作区域。可以显式发送此消息或使用 ListView_SetWorkAreas 宏。
LVM_SORTGROUPS	使用应用程序定义的比较函数按列表视图控件中的 ID 对组进行排序。
LVM_SORTITEMS	使用应用程序定义的比较函数对列表视图控件的项进行排序。每个项的索引会更改以反映新序列。可以显式发送此消息，也可以使用 ListView_SortItems 宏发送。
LVM_SORTITEMSEX	使用应用程序定义的比较函数对列表视图控件的项进行排序。每个项的索引会更改以反映新序列。可以显式发送此消息，也可以使用 ListView_SortItemsEx 宏发送。
LVM_SUBITEMHITTEST	确定位于给定位置的列表视图项或子项。可以显式发送此消息，也可以使用 ListView_SubItemHitTest 宏发送。
LVM_UPDATE	更新列表视图项。如果列表视图控件具有 LVS_AUTOARRANGE 样式，则此宏会导致排列列表视图控件。可以显式发送此消息，也可以使用 ListView_Update 宏发送。

通知

主题	内容
LVN_BEGINDRAG	通知列表视图控件的父窗口正在启动涉及鼠标左键的拖放作。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_BEGINLABELEDIT	通知列表视图控件的父窗口，说明项目的标签编辑开始。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_BEGINRDRAG	通知列表视图控件的父窗口正在启动涉及鼠标右键的拖放作。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_BEGINSCROLL	在滚动作启动时通知列表视图控件的父窗口。
LVN_COLUMNCLICK	通知列表视图控件的父窗口单击列。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_COLUMNDROPDOWN	当按下列表视图的下拉按钮时，列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_COLUMNOVERFLOWCLICK	单击列表视图控件溢出按钮时，由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_DELETEALLITEMS	通知列表视图控件的父窗口，控件中的所有项都将被删除。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_DELETEITEM	通知列表视图控件的父窗口，该项目即将被删除。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ENDLABELEDIT	通知列表视图控件的父窗口，说明项目的标签编辑结束时间。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ENDSCROLL	在滚动作结束时通知列表视图控件的父窗口。
LVN_GETDISPINFO	由列表视图控件发送到其父窗口。这是父窗口提供显示或排序列表视图项所需的信息的请求。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_GETEMPTYMARKUP	当控件没有项时，由列表视图控件发送到其父窗口。此通知代码以 WM_NOTIFY 消息的形式发送。 LVN_GETEMPTYMARKUP 通知代码是请求父窗口提供标记文本。
LVN_GETINFOTIP	由具有 LVS_EX_INFOTIP 扩展样式的大型图标视图列表视图控件发送。当列表视图控件请求在工具提示中显示的其他文本信息时，将发送此通知。它以 WM_NOTIFY 消息的形式发送。
LVN_HOTTRACK	当用户将鼠标移到项上时，由列表视图控件发送。此通知仅由具有 LVS_EX_TRACKSELECT 扩展列表视图样式的列表视图控件发送。它以 WM_NOTIFY 消息的形式发送。
LVN_INCREMENTALSEARCH	通知列表视图控件的父窗口已启动增量搜索。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_INSERTITEM	通知列表视图控件的父窗口插入了新项。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ITEMACTIVATE	当用户激活项时，由列表视图控件发送。此通知以 WM_NOTIFY 消息的形式发送。
LVN_ITEMCHANGED	通知列表视图控件的父窗口项已更改。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ITEMCHANGING	通知列表视图控件的父窗口项正在更改。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_KEYDOWN	通知列表视图控件的父窗口已按下键。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_LINKCLICK	通知列表视图控件的父窗口已单击链接。此通知以 WM_NOTIFY 消息的形式发送。
LVN_MARQUEEBEGIN	通知列表视图控件的父窗口，边界框（选框）已开始。此通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ODCACHEHINT	当显示区域的内容发生更改时，虚拟列表视图控件发送。例如，当用户滚动控件的显示时，列表视图控件会发送此通知。 LVN_ODCACHEHINT 通知代码以 WM_NOTIFY 消息的形式发送。
LVN_ODFINDITEM	当需要所有者查找特定回调项时，虚拟列表视图控件发送。例如，当控件收到快捷键盘输入或收到 LVM_FINDITEM 消息时，控件将发送此通知。
LVN_ODSTATECHANGED	当项或项范围的状态发生更改时，列表视图控件发送。此通知以 WM_NOTIFY 消息的形式发送。
LVN_SETDISPINFO	通知列表视图控件的父窗口，它必须更新它为项维护的信息。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_CLICK（列表视图）	当用户单击带有鼠标左键的项时，由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_CUSTOMDRAW（列表视图）	由列表视图控件发送，以通知其父窗口有关绘图作的信息。此通知以 WM_NOTIFY 消息的形式发送。
NM_DBLCLK（列表视图）	当用户双击带有鼠标左键的项时，由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_HOVER（列表视图）	鼠标悬停在项上时由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_KILLFOCUS（列表视图）	通知列表视图控件的父窗口控件已失去输入焦点。 NM_KILLFOCUS（列表视图）以 WM_NOTIFY 邮件的形式发送。
NM_RCLICK（列表视图）	当用户单击具有鼠标右键的项时，由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RDBLCLK（列表视图）	当用户双击具有鼠标右键的项时，由列表视图控件发送。此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RELEASEDCAPTURE（列表视图）	通知列表视图控件的父窗口，该控件正在释放鼠标捕获。此通知以 WM_NOTIFY 消息的形式发送。
NM_RETURN（列表视图）	通知列表视图控件的父窗口，该控件具有输入焦点，并且用户已按下 Enter 键。 NM_RETURN以 WM_NOTIFY 消息的形式发送。
NM_SETFOCUS（列表视图）	通知列表视图控件的父窗口，该控件已收到输入焦点。 NM_SETFOCUS（列表视图）以 WM_NOTIFY 邮件的形式发送。

结构

主题	内容
LVBKIMAGE	包含有关列表视图控件的背景图像的信息。此结构用于设置和检索背景图像信息。
LVCOLUMN	包含有关报表视图中的列的信息。此结构用于创建和作列。此结构取代LV_COLUMN结构。
LVFINDINFO	包含搜索列表视图项时使用的信息。此结构与LV_FINDINFO相同，但已重命名为适合标准命名约定。
LVFOOTERINFO	包含列表视图控件中页脚的信息。
LVFOOTERITEM	包含有关页脚项的信息。
LVGROUP	用于设置和检索组。
LVGROUPMETRICS	包含有关列表视图控件中组显示的信息。
LVHITTESTINFO	包含有关命中测试的信息。此结构已扩展，以适应子项命中测试。它与 LVM_HITTEST 和 LVM_SUBITEMHITTEST 消息及其相关宏相关联。此结构取代了 LVHITTESTINFO 结构。
LVINSERTGROUPSORTED	用于对组进行排序。它与 LVM_INSERTGROUPSORTED一起使用。
LVINSERTMARK	用于描述插入点。
LVITEM	指定或接收列表视图项的属性。此结构已更新，以支持启用项缩进的新掩码值（LVIF_INDENT）。此结构取代 LV_ITEM 结构。
LVITEMINDEX	包含有关列表视图项的索引信息。
LVSETINFOTIP	提供有关要设置的工具提示文本的信息。
LVTILEINFO	提供有关在磁贴视图中显示列表视图控件中的项的信息。
LVTILEVIEWINFO	提供有关在磁贴视图中显示列表视图控件的信息。
NMITEMACTIVATE	包含有关 LVN_ITEMACTIVATE 通知代码的信息。
NMLISTVIEW	包含有关列表视图通知代码的信息。此结构与 NM_LISTVIEW 结构相同，但已重命名为适合标准命名约定。
NMLVCACHEHINT	包含用于更新缓存项信息的信息，以用于虚拟列表视图。
NMLVCUSTOMDRAW	包含特定于 NM_CUSTOMDRAW（列表视图）的信息列表视图控件发送的通知代码。
NMLVDISPINFO	包含有关 LVN_GETDISPINFO 或 LVN_SETDISPINFO 通知代码的信息。此结构与 LV_DISPINFO 结构相同，但已重命名以适应标准命名约定。
NMLVEMPTYMARKUP	在 LVN_GETEMPTYMARKUP 通知上发送。
NMLVFINDITEM	包含所有者需要查找虚拟列表视图控件请求的项目的信息。此结构与 LVN_ODFINDITEM 通知代码一起使用。
NMLVGETINFOTIP	包含和接收显示项的工具提示所需的列表视图项信息。此结构与 LVN_GETINFOTIP 通知代码一起使用。
NMLVKEYDOWN	包含用于处理 LVN_KEYDOWN 通知代码的信息。此结构与 NMLVKEYDOWN 结构相同，但已重命名为适合标准命名约定。
NMLVLINK	包含有关 LVN_LINKCLICK 通知的信息。
NMLVODSTATECHANGE	包含用于处理 LVN_ODSTATECHANGED 通知代码的信息的结构。
NMLVSCROLL	提供有关滚动作的信息。

常数

主题	内容
扩展 List-View 样式	使用 LVM_SETEXTENDEDLISTVIEWSTYLE 消息或其中一个 ListView_SetExtendedListViewStyle 或 ListView_SetExtendedListViewStyleEx 宏来使用这些扩展列表视图控件样式。
List-View 项状态	项的状态值由项的状态、可选的覆盖掩码索引和可选的状态图像掩码索引组成。项的状态确定其外观和功能。状态可以是零或以下一个或多个值：
List-View 窗口样式	以下窗口样式特定于列表视图控件。

通过

列表视图

综述

宏

消息

通知

结构

常数

反馈

其他资源