LVM_GETNEXTITEMINDEX消息
检索指定列表视图控件中与指定属性和与其他项的关系匹配的项的索引。 显式发送此消息或使用 ListView_GetNextItemIndex 宏发送。
参数
-
wParam [in， out]
-
指向要开始搜索的项的 LVITEMINDEX 结构的指针，或 -1 以查找与指定标志匹配的第一个项。 调用进程负责分配此结构并设置其成员。
-
lParam
-
指定与参数 wParam 中列出的项的关系。 这可以是以下值的一个或组合：
值 含义 - 按索引搜索。
- LVNI_ALL
按索引（默认值）搜索后续项。 - 按与要开始搜索的项的索引的物理关系进行搜索。
- LVNI_ABOVE
搜索位于指定项上方的项。 - LVNI_BELOW
搜索位于指定项下方的项。 - LVNI_TOLEFT
搜索位于指定项左方的项。 - LVNI_PREVIOUS
Windows Vista 及更高版本： 搜索在 wParam 中指定的项之前排序的项。 LVNI_PREVIOUS标志不是方向标志， (LVNI_ABOVE查找位于上面的项，而LVNI_PREVIOUS将找到之前排序的项目。) LVNI_PREVIOUS 标志基本上反转LVM_GETNEXTITEM或LVM_GETNEXTITEMINDEX消息执行的搜索逻辑。 - LVNI_TORIGHT
搜索位于指定项右方的项。 - LVNI_DIRECTIONMASK
Windows Vista 及更高版本： 具有如下值的方向标志掩码：LVNI_ABOVE |LVNI_BELOW |LVNI_TOLEFT |LVNI_TORIGHT。 - 可以使用一个或以下值的组合来指定要查找的项的状态：
- LVNI_CUT
该项设置了 LVIS_CUT 状态标志。 - LVNI_DROPHILITED
该项目设置了 LVIS_DROPHILITED 状态标志 - LVNI_FOCUSED
该项设置了 LVIS_FOCUSED 状态标志。 - LVNI_SELECTED
该项设置了 LVIS_SELECTED 状态标志。 - LVNI_STATEMASK
Windows Vista 及更高版本： 值为的状态标志掩码，如下所示：LVNI_FOCUSED |LVNI_SELECTED |LVNI_CUT |LVNI_DROPHILITED。 - 按项目外观或按组搜索。
- LVNI_VISIBLEORDER
Windows Vista 及更高版本： 搜索可见顺序。 - LVNI_VISIBLEONLY
Windows Vista 及更高版本： 搜索可见项。 - LVNI_SAMEGROUPONLY
Windows Vista 及更高版本： 搜索当前组。 - 如果某个项未设置所有指定的状态标志，则搜索将继续执行下一项。
返回值
如果成功，则返回 TRUE ，否则返回 FALSE 。
备注
请注意，以下标志（仅用于 Windows Vista）与使用中的任何其他标志互斥：LVNI_PREVIOUS、LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 标头 |
|