通过

LVM_GETNEXTITEM消息

  • 项目

搜索具有指定属性且具有与指定项的指定关系的列表视图项。 可以显式发送此消息，也可以使用 ListView_GetNextItem 宏发送。

参数

wParam

要开始搜索的项的索引，或 -1 以查找与指定标志匹配的第一个项。 指定的项本身不在搜索范围内。

lParam

指定与 wParam 中指定的项的关系。 这可以是以下值的一个或组合：

值 含义
按索引搜索。
LVNI_ALL
 按索引（默认值）搜索后续项。
LVNI_PREVIOUS
 Windows Vista 及更高版本： 搜索在 wParam 中指定的项之前排序的项。 LVNI_PREVIOUS标志不是定向的， (LVNI_ABOVE将找到位于上面位置的项，而LVNI_PREVIOUS将找到之前排序的项目。) LVNI_PREVIOUS 标志基本上反转 LVM_GETNEXTITEM 或 LVM_GETNEXTITEMINDEX 消息执行的搜索逻辑。
按与要开始搜索的项索引的物理关系进行搜索。
LVNI_ABOVE
 搜索位于指定项上方的项。
LVNI_BELOW
 搜索位于指定项下方的项。
LVNI_TOLEFT
 搜索位于指定项左方的项。
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 及更高版本： 搜索当前组。
如果某个项未设置所有指定的状态标志，则搜索将继续执行下一项。

返回值

如果成功，则返回下一项的索引，否则返回 -1。

备注

请注意，以下标志（仅用于 Windows Vista）与正在使用的任何其他标志互斥：LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h