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 中指定的项的关系。 这可以是以下值的一个或组合:
值 | 含义 |
---|---|
|
|
|
按索引(默认值)搜索后续项。 |
|
|
|
搜索位于指定项上方的项。 |
|
搜索位于指定项下方的项。 |
|
搜索位于指定项左方的项。 |
|
Windows Vista 及更高版本: 搜索指定项之前的项。 LVNI_PREVIOUS标志不是定向 (LVNI_ABOVE 查找位于上面的项,而LVNI_PREVIOUS将找到之前排序的项目。) LVNI_PREVIOUS 标志实质上反转通过LVM_GETNEXTITEM或LVM_GETNEXTITEMINDEX消息执行的搜索逻辑。 |
|
搜索位于指定项右方的项。 |
|
Windows Vista 及更高版本: 具有如下值的方向标志掩码:LVNI_ABOVE |LVNI_BELOW |LVNI_TOLEFT |LVNI_TORIGHT。 |
|
|
|
该项设置了 LVIS_CUT 状态标志。 |
|
该项目设置了 LVIS_DROPHILITED 状态标志 |
|
该项设置了 LVIS_FOCUSED 状态标志。 |
|
该项设置了 LVIS_SELECTED 状态标志。 |
|
Windows Vista 及更高版本: 值为的状态标志掩码,如下所示:LVNI_FOCUSED |LVNI_SELECTED |LVNI_CUT |LVNI_DROPHILITED。 |
|
|
|
Windows Vista 及更高版本: 搜索可见顺序。 |
|
Windows Vista 及更高版本: 搜索可见项。 |
|
Windows Vista 及更高版本: 搜索当前组。 |
|
返回值
无
备注
请注意,以下标志(仅用于 Windows Vista)与使用中的任何其他标志互斥:LVNI_PREVIOUS、LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | commctrl.h |