ListView_GetNextItem 宏 (commctrl.h)

搜索具有指定属性的列表视图项,并将指定的关系承载到指定项。 可以使用此宏或显式发送 LVM_GETNEXTITEM 消息。

语法

int ListView_GetNextItem(
   HWND hwnd,
   int  i,
   UINT flags
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

i

类型:int

要开始搜索的项的索引,或 -1 查找与指定标志匹配的第一项。 指定的项本身将从搜索中排除。

flags

类型:UINT

所请求项与指定项的几何关系,如果指定,则为所请求项的状态。 有关可能值的列表,请参阅 LVM_GETNEXTITEM 消息中的 lParam 参数的说明。 如果某个项未设置所有指定的状态标志,则搜索将继续执行下一项。

返回值

类型:int

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

要求

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