ListView_GetNextItemIndex 宏 (commctrl.h)

  • 项目

获取具有指定属性和与另一个特定项的关系的特定列表视图控件中项的索引。 使用此宏或显式发送 LVM_GETNEXTITEMINDEX 消息。

语法

void ListView_GetNextItemIndex(
  [in]       hwnd,
  [in, out]  plvii,
             flags
);

参数

[in] hwnd

类型： HWND

列表视图控件的句柄。

[in, out] plvii

类型： LVITEMINDEX*

指向项开始搜索的 LVITEMINDEX 结构的指针，或 -1 用于查找与指定标志匹配的第一个项。 调用进程负责分配此结构并设置其成员。

flags

类型： LPARAM

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

值 含义
按索引搜索。
LVNI_ALL
 按索引（默认值）搜索后续项。
按与要开始搜索的项的索引的物理关系进行搜索。
LVNI_ABOVE
 搜索位于指定项上方的项。
LVNI_BELOW
 搜索位于指定项下方的项。
LVNI_TOLEFT
 搜索位于指定项左方的项。
LVNI_PREVIOUS
 Windows Vista 及更高版本： 搜索指定项之前的项。 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 及更高版本： 搜索当前组。
如果某个项未设置所有指定的状态标志，则搜索将继续执行下一项。

返回值

无

备注

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

要求

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

另请参阅

LVM_GETNEXTITEM