通过

ListView_GetNextItemIndex宏 （commctrl.h）

  • 项目

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

语法

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      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 及更高版本： 搜索当前组。
如果某个项未设置所有指定的状态标志，则搜索将继续执行下一项。

返回值

类型：BOOL

如果成功，则返回 TRUE;否则返回 FALSE。

言论

请注意，以下标志仅与 Windows Vista 一起使用，彼此排斥：LVNI_PREVIOUS、LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。

要求

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

另请参阅

LVM_GETNEXTITEM